Skip to main content
GET
列出模型

简介

获取当前 API Key 可用的全部模型列表。同一接口路径 https://api.gravitex.ai/v1/models 会根据请求头自动返回对应平台的标准格式,无需切换接口或维护多份代码。

自动格式识别

根据请求头中的认证方式判断客户端类型,自动以 OpenAI / Anthropic / Gemini 的官方 ListModels 响应结构返回,让原生 SDK 可以直接对接。

格式识别规则

若同时携带多种凭证,优先级为:Anthropic > Gemini > OpenAI。

认证

string
OpenAI 兼容认证,格式:Bearer sk-xxxxxxxxxx
string
Anthropic 认证,直接填写 API Key(不带 Bearer 前缀)
string
Anthropic 协议版本,如 2023-06-01
string
Gemini 认证,直接填写 API Key

请求示例

响应示例

响应字段

OpenAI 格式

Anthropic 格式

Gemini 格式

错误处理

错误响应示例(OpenAI 格式):

最佳实践

  • 建议缓存:模型列表变化不频繁,推荐在客户端缓存 1 小时以上,避免高频请求。
  • 启动校验:可在服务启动时调用一次本接口,校验 Key 可用性及目标模型是否在权限范围内。
  • 权限相关:返回列表会随 API Key 的开通权限动态变化,不同 Key 看到的模型可能不同。
  • SDK 直连:使用 OpenAI / Anthropic / Google 官方 SDK 时,只需将 Base URL 指向 https://api.gravitex.ai,无需任何额外适配。
Python 示例依赖:
  • OpenAI 格式:pip install openai
  • Anthropic 格式:pip install anthropic
  • Gemini 格式:pip install requests