API reference

API reference · API

List the live model catalog

GET/v1/modelsNo key

The union of every configured upstream, normalized and deduped, with the 10 autopilot policy ids prepended when the catalog is not empty. Pricing fields are independently nullable: an upstream that publishes no price yields null rather than a guess.

Answer 200

The catalog with per model pricing and context length.

Fields of the 200 answer
FieldTypeWhat it is
object"list"
dataarray of Model
data[].idstringNamespaced as vendor/model.
data[].object"model"
data[].createdintegerUnix seconds when the upstream first listed it, where it says.
data[].owned_bystringThe serving adapter: openai, anthropic, openrouter, or antimatter.
data[].namestring
data[].context_lengthinteger or null
data[].max_output_tokensintegerThe most tokens one answer may generate on this model, where the upstream publishes it. max_tokens is clamped here. Absent when unpublished.
data[].pricingPricing
data[].pricing.promptPer1Mnumber or nullUSD per million prompt tokens. Null when the upstream publishes no price.
data[].pricing.completionPer1Mnumber or nullUSD per million completion tokens. Null when the upstream publishes no price.
data[].pricing.cacheReadPer1Mnumber or nullUSD per million prompt tokens the vendor served from its own cache. Absent or null when the vendor publishes none, and such tokens bill at the prompt rate.
data[].pricing.cacheWritePer1Mnumber or nullUSD per million prompt tokens written into the vendor's cache. Absent or null when the vendor publishes none, and such tokens bill at the prompt rate.
data[].pricing_unknownbooleanTrue when no price could be established for this model. It is refused on house money (503 pricing_unavailable) and must never be read as free. Absent on the autopilot entries.
data[].modalitystringOne of "text", "multimodal".
data[].output_modalitiesarray of stringWhat the model produces, where the upstream says: text, image, speech, transcription or embeddings. Image, speech and transcription models are served by /v1/images/generations and /v1/audio/*, embedding models by /v1/embeddings and listed at GET /v1/embeddings/models.
data[].input_modalitiesarray of stringWhat the model reads, where the upstream says: text, image, audio, file or video. Absent when the upstream does not say.
data[].holders_only_untilintegerUnix seconds when a model still in its $ANTI holders' window opens to everyone. Until then it serves holders only (the account that minted the key holds the lowest holder tier) and anyone else is refused with 403 holder_only; autopilot never routes a non holder to it. Absent on every other model, and on a deployment without holder tiers.
Antimatter