List models

GET/v1/models

Used to discover available models during SDK migration. Query parameters can filter by modality, capability, or provider.

Back to Models and Providers endpoint list

Request parameters

FieldTypeRequiredDescription

modalityqueryNoFilter by modality.

capabilityqueryNoFilter by capability.

providerqueryNoFilter by provider ID.

exclude_mockqueryNoWhether to exclude mock or diagnostic models; defaults to true.

available_onlyqueryNoOnly return models available to the current tenant.

Response fields

FieldTypeRequiredDescription

objectstringNoOpenAI-style object type.

dataarrayYesModel list.

data[]objectYes单个models条目。

data[].idstringYesGlobalRouter model ID.

data[].objectstringYes固定为 model。

data[].vendor_idstringYes厂商 ID。

data[].vendor_namestringYes厂商名称。

data[].vendorobjectYes厂商摘要，包含 id 与 name。

data[].vendor.idstringYes厂商 ID。

data[].vendor.namestringYes厂商名称。

data[].providersarrayYes支持该models的 Provider 列表。

data[].providers[]objectYes单个 Provider 摘要。

data[].providers[].idstringYesProvider ID。

data[].providers[].namestringYesProvider 名称。

data[].providers[].statusstringYesProvider 状态。

data[].providers[].descriptionstringNoProvider description.

data[].display_namestringYesmodels展示名称。

data[].categorystringYesmodels分类。

data[].subtypestringNomodels子类型。

data[].modalitystringYes主模态。

data[].capabilitiesarrayYesCapability tags.

data[].capabilities[]stringYes单个能力标签。

data[].tagsarrayYesmodels标签。

data[].tags[]stringYes单个models标签。

data[].input_modalitiesarrayYes支持的输入模态。

data[].input_modalities[]stringYes单个输入模态。

data[].output_modalitiesarrayYes支持的输出模态。

data[].output_modalities[]stringYes单个输出模态。

data[].supported_parametersarrayYesmodels支持的请求parameters。

data[].supported_parameters[]stringYes单个支持parameters。

data[].execution_modestringYes执行模式。

data[].billing_unitstringYes计费单位。

data[].context_windowintegerNo上下文长度。

data[].input_price_per_1mnumberYes每百万输入 token 或单位价格。

data[].output_price_per_1mnumberYes每百万输出 token 或单位价格。

data[].default_timeout_secondsintegerNo默认超时时间。

data[].provider_statusstringNo默认 Provider 状态。

data[].provider_configuredbooleanYes当前 Provider 是否已配置。

data[].routablebooleanYes当前models是否可路由。

data[].provider_kindstringYesProvider 类型，例如 real 或 mock。

data[].mock_providerbooleanYes是否为 mock Provider。

data[].dev_onlybooleanYes是否仅用于开发。

data[].diagnostic_onlybooleanYes是否仅用于诊断。

Errors

401UNAUTHORIZED

Missing or invalid Authorization Bearer token.

403FORBIDDEN

The current API key is not allowed to call this scope or model.

429RATE_LIMITED

请求过快或异步任务队列已满，请降低并发或稍后重试。

Endpoints

Request parameters

Response fields

Errors