模型列表

模型列表接口返回当前密钥可以访问的模型。它比在代码中维护静态名称更可靠。

OpenAI Compatible 模型列表

curl https://sprelaytoken.com/v1/models \
  -H "Authorization: Bearer $SPRELAY_API_KEY"

典型响应：

{
  "object": "list",
  "data": [
    {
      "id": "gpt-5.4",
      "object": "model"
    }
  ]
}

Python 读取模型 ID

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["SPRELAY_API_KEY"],
    base_url="https://sprelaytoken.com/v1",
)

for model in client.models.list().data:
    print(model.id)

Gemini 模型列表

curl https://sprelaytoken.com/v1beta/models \
  -H "x-goog-api-key: $SPRELAY_API_KEY"

API 列表与模型广场的区别

• API 列表以当前密钥权限为视角。
• 模型广场提供价格、分组、供应商和端点类型等展示信息。
• 创建客户端配置时，模型 ID 以 API 返回值为准；选择分组和比较费用时查看模型广场。

缓存策略

应用可以短时间缓存模型列表，但不要把列表永久写死。站点调整模型或分组后，应允许管理员刷新缓存。请求失败并提示模型不可用时，重新拉取列表再判断。

列表为空

依次检查：

1. 密钥是否启用且未过期。
2. 密钥是否选择了有效分组。
3. 分组当前是否包含可用模型。
4. 模型限制是否把全部模型排除。