Skip to content
Numes

API reference · List models

Models

List models

List every model your key can use right now, priced in the key's billing currency.

GEThttps://api.numes.ai/api/v1/models

Lists only models with at least one available endpoint priced in your key's currency. Each row describes one representative endpoint; use List model endpoints to compare every endpoint that serves a model. context_length bounds prompt plus output; the optional max_input_tokens is a separate input limit. Without sort, models are ordered by ID. Filter with comma-separated output_modalities and supported_parameters. See Models for the full field guide.

Authorization

AuthorizationheaderRequired

Bearer inference key. Charges settle in the key's billing currency. Authorization: Bearer $NUMES_API_KEY

Headers

X-Request-Idstring

Correlation ID, not an idempotency key. Inference request IDs recorded with a generation are unique per account. A traffic-admitted request reusing a recorded ID returns 400 invalid_request. Traffic admission rejection takes precedence over this conflict, including for reused IDs; it performs no generation lookup and writes no generation, result or attempt. Rate-limit rejection returns 429 rate_limited with Retry-After; an inference limiter outage retains 500 server.

Length1–128

Query parameters

output_modalitiesstring
supported_parametersstring
sortenum<string>
One ofpricing-low-to-highpricing-high-to-lowcontext-high-to-lownewest

Responses

200Model catalogapplication/json

Headers

X-Catalogue-Generationstring

The completed worker publication identifier.

X-Catalogue-Supply-Captured-Atstring<date-time>

Consistent supply capture time; supply is captured every 30 seconds by default and a new healthy response is at most one minute old.

X-Catalogue-Staleboolean

True during ordinary stale browsing, which ends at five minutes of supply age.

X-Catalogue-Statistics-Availableboolean

Whether the publication has fresh statistical coverage.

X-Catalogue-Statistics-As-Ofstring<date-time>

Completed statistical coverage time, when any coverage is pinned.

X-Request-Idstring

Correlation identifier assigned or accepted by the service.

BodyModelListResponseapplication/json

dataarray<object>Required
Show18 child attributes
idstringRequired
Pattern^[a-z0-9][a-z0-9._-]{0,99}/[A-Za-z0-9][A-Za-z0-9._:-]{0,291}$
canonical_slugstringRequired
Pattern^[a-z0-9][a-z0-9._-]{0,99}/[A-Za-z0-9][A-Za-z0-9._:-]{0,254}$
namestringRequired
createdinteger<int64>Required
context_lengthintegerRequired
architectureobjectRequired
Show5 child attributes
modalitystringRequired
input_modalitiesarray<enum<string>>Required
One oftextimagefileaudio
output_modalitiesarray<enum<string>>Required
One oftextimageaudioembeddings
tokenizerstringRequired
instruct_typestring | null
pricingobjectRequired

Exact per-unit prices in the inference key's immutable billing currency. For BTC keys, values are Bitcoin base units (1 is one satoshi), token prices have up to thirty decimal places, and clients may display them with BIP177 notation such as ₿123/M.

Show10 child attributes
promptstringRequired
Pattern^-?[0-9]+(\.[0-9]+)?$
completionstringRequired
Pattern^-?[0-9]+(\.[0-9]+)?$
requeststringRequired
Pattern^-?[0-9]+(\.[0-9]+)?$
imagestringRequired
Pattern^-?[0-9]+(\.[0-9]+)?$
audiostringRequired
Pattern^-?[0-9]+(\.[0-9]+)?$
pricing_basisenum<string>
One offixedusd_indexed
referenceobject
Show5 child attributes
idstring<uuid>Required
policystringRequired
usd_per_btcstringRequired
observed_atstring<date-time>Required
expires_atstring<date-time>Required
usd_ratesmap<string, string>

USD anchor rates for the same displayed price categories; present only for USD-indexed Bitcoin schedules.

input_cache_readstring
Pattern^[0-9]+(\.[0-9]+)?$
input_cache_writestring
Pattern^[0-9]+(\.[0-9]+)?$
supported_parametersarray<string>Required
billing_currencyenum<string>
One ofUSDBTC
usage_meterstring

Gateway billing-unit algorithm; not the native tokenizer used for context limits.

descriptionstring
max_input_tokensinteger

Independent token input ceiling of the representative offer, when declared. This is separate from the combined context window.

Range≥ 1
maximum_output_lengthinteger | null
Range≥ 1
embeddingsboolean
Defaultfalse
supported_hosted_toolsarray<enum<string>>
One ofopenrouter.web_search@1openrouter.web_fetch@1openrouter.datetime@1openrouter.image_generation@1openrouter.apply_patch@1openrouter.fusion@1openrouter.advisor@1openrouter.subagent@1openai.web_search@1openai.file_search@1openai.code_interpreter@1openai.image_generation@1openai.shell@1openai.mcp@1openai.connectors@1openai.tool_search@1openai.skills@1anthropic.web_search@1anthropic.web_fetch@1anthropic.code_execution@1anthropic.advisor@1anthropic.tool_search@1anthropic.mcp@1google.search@1google.maps@1google.url_context@1google.file_search@1google.code_execution@1
reasoningobject
Show5 child attributes
default_effortstring | null
default_enabledboolean
mandatoryboolean
supports_max_tokensboolean
supported_effortsarray<enum<string>>
One ofnoneminimallowmediumhighxhighmax
top_providerobject
Show3 child attributes
context_lengthintegerRequired
max_completion_tokensinteger | nullRequired
Range≥ 1
is_moderatedboolean
accessobject

Numes extension present only on a shared model: an access-restricted variant whose `id` is the canonical slug plus `:org-<handle>`, usable only by members of that organization (docs/MODEL_SHARING.md).

Show2 child attributes
kindenum<string>Required
Valueorganization
organizationobjectRequired
Show2 child attributes
handlestringRequired
Pattern^[a-z0-9]([a-z0-9-]{0,30}[a-z0-9])$
display_namestringRequired
ErrorCompatible error envelopeapplication/json

Headers

X-Request-Idstring

Correlation identifier assigned or accepted by the service.

Retry-Afterinteger

Optional delay in seconds for retryable rate or availability errors.

Range≥ 1

BodyErrorResponseapplication/json

errorobjectRequired
Show3 child attributes
codeintegerRequired
messagestringRequired
metadataobject
openrouter_metadataobject