协议兼容
HOYOAI 是聚合网关：用 一把 Key、统一域名 接入多家模型协议。按客户端选择正确路径即可。
域名怎么填
| 场景 | 推荐写法 |
|---|---|
| OpenAI SDK / 多数兼容库 | https://api.hoyoai.cn/v1 |
| 部分 IDE / 代理「不要带 /v1」 | https://api.hoyoai.cn（报 404 时与上一行二选一试） |
| Anthropic / Claude Code | 通常 https://api.hoyoai.cn（由客户端自行拼 /v1/messages） |
| Gemini 原生客户端 | 指向 https://api.hoyoai.cn，路径以客户端与网关为准 |
协议对照
| 协议 | 方法与路径 | 典型客户端 |
|---|---|---|
| OpenAI Chat Completions | POST /v1/chat/completions | OpenAI SDK、Cursor、多数应用 |
| OpenAI Completions | POST /v1/completions | 旧版补全 |
| OpenAI Responses | POST /v1/responses | 新版 Agents / Responses 客户端 |
| OpenAI Images | POST /v1/images/generations | 文生图 |
| OpenAI Models | GET /v1/models | 列出模型 |
| Anthropic Messages | POST /v1/messages | Claude Code、Anthropic SDK |
| Gemini 原生 | 如 POST /v1beta/models/{model}:generateContent | Gemini CLI（若支持自定义端点） |
默认优先用 Chat Completions 验证 Key 与网络，再切到专用协议。
与「直接调官方」的差异
- 不要在请求里附带第三方聚合站的专有请求头或专有路由字段（那些只对原平台生效）。
- 不要假设模型 slug 与 OpenAI / Anthropic / Google 官网完全一致；以 HOYOAI 模型广场为准。
- 上游能力（工具调用、视觉、最长上下文等）因模型而异，以实际返回与广场说明为准。
推荐阅读顺序
- 快速开始
- Chat Completions
- 若用 Claude Code → Messages + 客户端集成
- 若用图像 → 图像生成