API 协议参考
支持的端点、多模态请求格式与常见 HTTP 状态码排查。
API 协议参考
支持端点列表
| 端点 | 方法 | 说明 |
|---|---|---|
/v1/models | GET | 查询当前 Key 可访问的模型列表 |
/v1/chat/completions | POST | OpenAI 标准对话与推理接口(支持 SSE 流式与 Tools) |
/v1/responses | POST | OpenAI Responses API(支持推理项与工具调用) |
/v1/messages | POST | Anthropic 原生 Messages 接口(支持 Extended Thinking) |
/v1/images/generations | POST | 图像生成接口 |
/v1/embeddings | POST | 向量嵌入接口 |
常见错误码
| 状态码 | 含义 | 处理建议 |
|---|---|---|
401 | API Key 无效或未传鉴权头 | 检查 Authorization: Bearer sk-... 或控制台 Key 状态 |
403 | 账户余额不足或模型权限受限 | 前往控制台检查账户余额与 Token 允许的模型白名单 |
429 | 触发并发或 RPM/TPM 限流 | 启用指数退避重试或升级账号分组 |
502 / 503 | 上游通道临时波动 | 网关会自动冷却故障节点并切换备用渠道,建议客户端保留 1-2 次重试 |