GRGlobalRouter Docs
Console

Models / GET

List models

Reads the visible model catalog for the current request context.

Endpoints

Mobile only shows the endpoint list. View parameter details and examples on desktop.

MethodEndpointDescription
GET/api/v1/modelsReads the visible model catalog for the current request context.
GET/api/v1/models/countCounts models that match the filters.
GET/api/v1/models/{author}/{slug}/endpointsReads provider endpoints, prices, and capabilities for one model.
GET/api/v1/providersReads the public provider list.
GET/api/v1/models

Useful for model pickers, pre-integration checks, or console views that show model capabilities, pricing, and routability.

Back to Models endpoint list

Request parameters

FieldTypeRequiredDescription
modalitystringNoFilter by modality, such as chat, image, video, or embedding.
capabilitystringNoFilter by capability, such as streaming, tool-call, or video_generation.
providerstringNoFilter by public provider ID.
input_modalitiesstring[]NoFilter by input modalities; may be repeated.
output_modalitiesstring[]NoFilter by output modalities; may be repeated.
available_onlybooleanNoOnly return models routable by the current tenant.

Response fields

FieldTypeRequiredDescription
dataobject[]YesModel list.
data[].idstringYesGlobalRouter model ID.
data[].canonical_slugstringNo与models ID 对齐的规范 slug。
data[].slugstringNomodels ID 的末段 slug。
data[].namestringNomodels展示名称。
data[].context_lengthintegerNo上下文长度。
data[].architectureobjectNomodels架构、输入/输出模态与 tokenizer 摘要。
data[].capabilitiesstring[]NoCapability tags.
data[].pricingobjectNoPublic pricing information.
data[].top_providerobjectNoOpenRouter 风格 Provider 限制摘要。
data[].supported_parametersstring[]Nomodels支持的公开请求parameters。
data[].vendor_idstringNo厂商 ID。
data[].vendor_namestringNo厂商名称。
data[].vendorobjectNo厂商摘要，包含 id 与 name。
data[].providersobject[]NoProvider summaries for this model.
data[].categorystringNomodels分类。
data[].routablebooleanNo当前models是否可路由。

Notes

  • Without an API key, this endpoint can be used for public discovery. With an API key, results also account for tenant permissions and the model allowlist.