Models
`GET /v1/models` — list every model Tomoul hosts, with pricing, capabilities, and region availability.
List models
curl https://api.tomoul.ai/v1/models \
-H "Authorization: Bearer $TOMOUL_KEY"
Optional query params:
?modality=embedding— filter by modality (chat,embedding,rerank,audio).?region=eu-helsinki1— only models available in this region.?provider=baai— only models from this provider.
Get a single model
curl https://api.tomoul.ai/v1/models/baai%2Fbge-m3 \
-H "Authorization: Bearer $TOMOUL_KEY"
URL-encode the slash in the slug (baai/bge-m3 → baai%2Fbge-m3).
Response fields
{
"id": "baai/bge-m3",
"object": "model",
"modality": "embedding",
"context_length": 8192,
"max_output_tokens": null,
"dimensions": 1024,
"regions": ["eu-helsinki1", "eu-frankfurt1"],
"capabilities": {
"tools": false,
"json_mode": false,
"vision": false,
"structured_output": false
},
"pricing": {
"prompt_per_million": 0.01,
"completion_per_million": null,
"cache_read_per_million": 0.001
},
"deprecated_at": null
}
| Field | Notes |
|---|---|
modality | One of chat, embedding, rerank, audio. |
context_length | Max input tokens. |
regions | Region codes where this model is currently served. |
capabilities | Booleans for optional features. Filter on these to find tools models. |
pricing | USD per million tokens. null if not applicable to the modality. |
deprecated_at | ISO timestamp when the model is scheduled for removal. null if not. |
Last updated 13 May 2026Edit this page on GitHub