协议与地址：Chat、Responses、Claude、Gemini
根地址、SDK base URL 与原生协议的前缀不同。
地址速查
| 协议 | 完整请求地址 | 鉴权与边界 |
|---|---|---|
| 模型列表 | GET https://api.aimirrorx.com/v1/models | Authorization: Bearer YOUR_API_KEY |
| OpenAI Chat | POST https://api.aimirrorx.com/v1/chat/completions | Bearer；需支持 Chat 的模型/渠道 |
| OpenAI Responses | POST https://api.aimirrorx.com/v1/responses | Bearer；需支持 Responses 的模型/渠道 |
| Claude Messages | POST https://api.aimirrorx.com/v1/messages | x-api-key 与 anthropic-version；需兼容 Messages 的渠道 |
| Gemini 原生 | POST https://api.aimirrorx.com/v1beta/models/MODEL_ID:generateContent | x-goog-api-key；需 Gemini 协议渠道 |
各协议需要对应渠道与模型支持。模型名应从 /v1/models 选择并确认协议兼容。图像、工具调用、结构化输出、缓存和推理参数也随模型与渠道变化。
Responses
curl https://api.aimirrorx.com/v1/responses \
-H "Authorization: Bearer $AIMIRRORX_API_KEY" \
-H 'Content-Type: application/json' \
-d '{"model":"MODEL_ID_FROM_V1_MODELS","input":"你好"}'Responses 与 Chat 的响应结构不同，不应只替换路径后沿用 Chat 解析器。后台任务的获取、取消、存储和历史响应能力不能据此推定可用；GET /v1/responses/:id 是否可用取决于任务插件支持。
Claude Messages
Claude SDK 的服务根地址通常设为 https://api.aimirrorx.com，由 SDK 拼接 /v1/messages。不要将它设为 OpenAI SDK 的 /v1 base URL 后再次拼接 /v1。
curl https://api.aimirrorx.com/v1/messages \
-H "x-api-key: $AIMIRRORX_API_KEY" \
-H 'anthropic-version: 2023-06-01' \
-H 'Content-Type: application/json' \
-d '{"model":"MODEL_ID_FROM_V1_MODELS","max_tokens":256,"messages":[{"role":"user","content":"你好"}]}'/v1/messages/count_tokens 当前未启用，不能假定 Claude 原生端点全部可用。
Gemini generateContent
原生请求使用 /v1beta，不是 /v1/v1beta。用请求头传密钥，避免将密钥放入 URL 查询参数与访问日志。
curl 'https://api.aimirrorx.com/v1beta/models/MODEL_ID_FROM_V1_MODELS:generateContent' \
-H "x-goog-api-key: $AIMIRRORX_API_KEY" \
-H 'Content-Type: application/json' \
-d '{"contents":[{"role":"user","parts":[{"text":"你好"}]}]}'流式操作为 :streamGenerateContent，SSE 参数与 SDK 版本应按客户端要求设置。Gemini 原生请求体与 OpenAI 格式不同；不要把 OpenAI 的 messages 直接发送到原生接口。