服务地址与接口
接入工具时，优先按 各工具教程 填写。本页供需要自己发送接口请求的用户查阅。只想配置现成工具的话，可以跳过本页。
常用地址
服务根地址：https://tonyai.link。
| 用途 | 方法 | 完整地址 |
|---|---|---|
| 查询模型（获取列表） | GET | https://tonyai.link/v1/models |
| Responses | POST | https://tonyai.link/v1/responses |
| Chat Completions | POST | https://tonyai.link/v1/chat/completions |
| Anthropic Messages | POST | https://tonyai.link/v1/messages |
地址相同不代表每个 Key 都能调用全部模型和协议。 以 Key 所在分组的接入说明为准；模型列表也不能单独证明某个模型支持所有接口。
查询模型
下面用于 macOS / Linux：打开终端，先把 YOUR_TONYAI_API_KEY 换成自己的 Key，再复制命令执行。
export TONYAI_API_KEY="YOUR_TONYAI_API_KEY"
curl --fail-with-body "https://tonyai.link/v1/models" \
-H "Authorization: Bearer $TONYAI_API_KEY"
unset TONYAI_API_KEY
成功时会显示一段 JSON 格式的文字。寻找每个模型的 id 值；例如 "id": "demo-model"，应复制 demo-model，不包含引号。这里的 demo-model 只是讲解格式，不是真实可用模型。若返回未授权，检查 Key 是否有效；若返回的列表不适用于当前工具，以该 Key 的分组接入说明为准。
直接调用时，本例使用 Authorization: Bearer 请求头。工具界面里的 API Key 输入框通常只填密钥本身。
请求失败时
| 返回结果 | 排查方向 |
|---|---|
| 401 | Key 缺失、无效或已停用 |
| 403 | Key、分组或访问规则不允许本次请求 |
| 404 | 地址拼接错误，或模型 / 接口不可用 |
| 429 | 触发请求限制，查看响应中的具体说明 |
这些是排查方向，具体原因以接口返回的信息为准。完整请求字段和高级功能需按选定协议及分组支持情况使用。