API reference

API reference · API

List the embedding models

GET/v1/embeddings/modelsNo key

The models POST /v1/embeddings serves, in the GET /v1/models entry shape, priced as they are billed. Read from the aggregator's own embeddings listing and kept apart from /v1/models, which lists the chat models. Empty when no upstream is configured.

Answer 200

The embedding models.

Headers: x-antimatter-request-id, x-request-id

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