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-m3baai%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
}
FieldNotes
modalityOne of chat, embedding, rerank, audio.
context_lengthMax input tokens.
regionsRegion codes where this model is currently served.
capabilitiesBooleans for optional features. Filter on these to find tools models.
pricingUSD per million tokens. null if not applicable to the modality.
deprecated_atISO timestamp when the model is scheduled for removal. null if not.
Last updated 13 May 2026Edit this page on GitHub