API 参考

本部分面向后端、脚本和 SDK 用户，说明 Arqel 的鉴权方式、基础 Chat Completions 请求格式和调用示例。

如果你是新手，只想接入 Cursor、Claude Code、Codex 或 CC Switch，请先看新手入门。这一部分主要给后端、脚本、SDK 和深度排障使用。

WARNING

每次请求都要填写 Arqel 控制台中显示的具体模型名。不要把模型家族名、其他平台别名或示例占位文字直接填入请求。

基础信息

text

Base URL: 以 Arqel 控制台显示为准，例如 https://arqel.net
Auth: Authorization: Bearer <API Key>

文档示例用于说明结构，不代表所有账号、区域或环境都使用同一个地址。

页面	内容
鉴权	Authorization header 和 Key 使用方式
Chat Completions	基础聊天补全请求格式
错误码	常见失败状态和排查方向

http

POST /chat/completions

json

{
  "model": "<从 Arqel 控制台复制的模型名>",
  "messages": [
    { "role": "user", "content": "你好" }
  ]
}

能力	文档状态	接入建议
Bearer Token 鉴权	已文档化	每个请求都带 `Authorization: Bearer <API Key>`
Chat Completions 基础文本请求	已文档化	使用 `model` + `messages` 作为基础结构
Streaming	未确认	不要默认传 `stream: true`；需要时先确认产品能力
Tool calling / function calling	未确认	不要照搬其他平台参数
JSON mode / structured output	未确认	不要默认启用；需要时先用测试 Key 验证
Embeddings	未确认	不要假设 `/embeddings` 可用
Images / Audio / 多模态输入	未确认	以控制台和产品说明为准
Responses API / Models list	未确认	不要把其他平台端点直接迁移过来
Agent 专用或非 OpenAI 请求协议	未确认	不要作为 Arqel 能力编写生产配置

“未确认”表示本站当前没有把该能力作为稳定接入面文档化。需要这些能力时，请使用独立测试 Key 验证，并等待产品或后端确认后再进入生产服务。

在把 Arqel 接入生产服务前，请确认这些信息：