模型列表

在配置客户端、切换默认模型或排查模型不可见前，先请求 GET /v1/models。这是当前 API Key 的实际可选模型清单，不会泄露内部渠道、账号、分组映射或专属价格。

bash

export AI_SHOP_API_KEY='sk-...'

curl 'https://ai.tavonilo.com/v1/models' \
  -H "Authorization: Bearer $AI_SHOP_API_KEY"

普通 OpenAI 兼容响应中的 data[].id 才是可填入客户端的模型 ID。公开价格页说明当前站点发布的能力与计费维度，但某个 Key 能否调用仍取决于分组、订阅、余额、模型映射和实时调度。

选择模型

为每个设备、应用或环境创建单独的 API Key。
用该 Key 请求模型列表，只复制返回的 data[].id。
先对选中的模型发送一条短小、非敏感请求。
再启用长上下文、工具、图像、流式或生产工作流。

不要从旧配置、截图、博客或相近别名猜测模型名。模型没有返回时，继续重试相似名称不会增加权限，只会制造难以诊断的失败。

Codex 的特殊响应

Codex CLI 和桌面应用会在模型请求中携带 client_version，服务端会返回 Codex 所需的模型清单格式。该响应供 Codex 使用，不应被通用 OpenAI 客户端当作 data[] 列表解析。

Codex 的根 Base URL 是 https://ai.tavonilo.com，并使用 wire_api = "responses"；其他 OpenAI 兼容客户端通常使用以 /v1 结尾的 Base URL。请按对应客户端教程配置，而不是混用两种地址形状。

常见恢复

401：确认 Key 未被撤销、认证头为 Authorization: Bearer，且没有复制到额外空白或引号。
403：检查 Key 的分组、模型权限、余额和订阅，而不是猜测另一个模型 ID。
404：确认请求是 /v1/models，没有写成控制台路径，也没有重复添加 /v1。
429：遵循 Retry-After（若存在），按队列和指数退避重试。
5xx 或超时：只在业务请求可安全重试时有限重试，保留时间、模型、HTTP 状态和请求 ID。

相关内容：模型与价格、鉴权与 API Key 和错误码与排障。