模型列表

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

OpenAI Compatible 模型列表

bash

# 调用模型列表端点，并从环境变量读取密钥。
# 这一请求不需要 JSON 正文。
curl https://sprelaytoken.com/v1/models \
  -H "Authorization: Bearer $SPRELAY_API_KEY"

典型响应：

json

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

响应中的 data 是模型数组，id 是请求时应原样填写的模型名称，object 只是对象类型说明。实际返回可能包含更多模型和字段。

Python 读取模型 ID

python

# os 用于读取环境变量，OpenAI 是官方兼容 SDK 的客户端类。
import os
from openai import OpenAI

# 不要把真实密钥直接写进脚本。
client = OpenAI(
    api_key=os.environ["SPRELAY_API_KEY"],
    base_url="https://sprelaytoken.com/v1",
)

# list() 发出 GET /v1/models；逐个打印可直接复制的模型 ID。
for model in client.models.list().data:
    print(model.id)

Gemini 模型列表

bash

# Gemini 原生模型列表使用站点根域名下的 /v1beta/models。
# x-goog-api-key 不需要 Bearer 前缀。
curl https://sprelaytoken.com/v1beta/models \
  -H "x-goog-api-key: $SPRELAY_API_KEY"

API 列表与模型广场的区别

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

缓存策略

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

列表为空

依次检查：

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

模型列表 ​

OpenAI Compatible 模型列表 ​

Python 读取模型 ID ​

Gemini 模型列表 ​

API 列表与模型广场的区别 ​

缓存策略 ​

列表为空 ​