接入文档

协议与 OpenAI 完全兼容。改 base_url 与 model，其余代码一行不用动。

快速开始

三步跑通第一次调用：

• 在控制台创建 API Key（sk- 开头）。
• 把 SDK 的 base_url 指向 https://api.xuanku.ai/v1。
• model 填模型广场里的模型标识，例如 deepseek-v4-pro。

from openai import OpenAI

client = OpenAI(
    base_url="https://api.xuanku.ai/v1",
    api_key="sk-你的Key",
)

resp = client.chat.completions.create(
    model="deepseek-v4-pro",
    messages=[{"role": "user", "content": "用一句话介绍你自己"}],
)
print(resp.choices[0].message.content)

鉴权

所有请求在 Authorization 头中携带 Bearer Token：

curl https://api.xuanku.ai/v1/models \
  -H "Authorization: Bearer sk-你的Key"

网关在同一次请求内完成三件事：校验 Key 状态与白名单、确认余额充足、锁定本次请求的上游通道。

对话接口

端点：POST /v1/chat/completions。请求体与 OpenAI 保持一致，支持 temperature、max_tokens、tools、response_format、thinking 等参数；多模态模型可直接传 image_url。

流式输出

设置 stream=true 即可获得 SSE 流式响应。分块计量同样准确，中途断流不影响已产生 token 的计费。

for chunk in client.chat.completions.create(..., stream=True):
    print(chunk.choices[0].delta.content or "", end="")

模型广场

下面的表格实时读取后台模型库，改价格、上下架都会同步到这里。切换模型不需要换 SDK、不需要换 Key，只改 model 字符串。

计费方式

平台共三种计费口径，按模型在广场中标注的方式结算：

• 扣费与用量日志在同一事务内完成，控制台可逐条核对到 request id。
• 无月费、无最低消费、无阶梯套餐，余额用完即停，不会自动续费。
• 余额不足返回 402，充值后立即可用。

错误码

客户端兼容

任何支持自定义 base_url 的 OpenAI 兼容客户端均可直接使用，包括 Claude Code、Codex、Cline / Roo、LangChain、LlamaIndex、Dify、Cursor、Chatbox、NextChat 等。