XycAi API 接入文档

XycAi 支持 OpenAI、Anthropic、Google Gemini 多种兼容格式接口。把官方 SDK 的 base URL 指向 XycAi，无需改动业务代码，即可调用 Claude / GPT / Gemini / GLM / DeepSeek / Kimi 等 20+ 厂商模型。

• Base URL：https://cn.chatapi.app（国内直连主端点；全球 / 备用端点见接口地址）
• 鉴权：API Key（sk-…），在控制台「API 密钥」创建，默认按厂家路由
• 协议：OpenAI 兼容（/v1/chat/completions）、Anthropic 原生（/v1/messages）、OpenAI Responses（/v1/responses，GPT 系列）、Gemini 原生（/v1beta/models/{model}:generateContent）、图像生成（/v1/images/generations）与视频生成（/v1/video/generations）

一、Base URL 与请求头

根据使用的 SDK / 协议选择对应的地址形式。选择端点后，下方自动给出可直接复制的 base URL：

不同协议的鉴权 Header 不同，按使用的协议选择：

二、准备工作

1. 注册并登录控制台

   打开 www.xycai.us 注册账号（国内站 www.xycai.cn 同一账户体系）。

2. 创建 API Key

   在「API 密钥」页面新建 Key。默认按厂家路由：选 Anthropic 就能用全部 Claude 模型，网关自动在该厂家的分组里选最便宜可用的一档；也可改为按模型或全部模型与厂家。详见 API 密钥与路由。

3. 确保账户有可用余额

   充值后即可调用；可在控制台「用量明细」查看每一笔消费。

三、第一个请求

下面用 claude-sonnet-5-5 发送一次 Chat Completions 请求（OpenAI 兼容协议，可直接调用任意厂家模型）。

from openai import OpenAI

client = OpenAI(
    base_url="https://cn.chatapi.app/v1",
    api_key="sk-xxxxxxxx",
)

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

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://cn.chatapi.app/v1",
  apiKey: "sk-xxxxxxxx",
});

const resp = await client.chat.completions.create({
  model: "claude-sonnet-5-5",
  messages: [{ role: "user", content: "用一句话介绍你自己。" }],
});
console.log(resp.choices[0].message.content);

curl https://cn.chatapi.app/v1/chat/completions \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5-5",
    "messages": [{"role": "user", "content": "用一句话介绍你自己。"}]
  }'

Anthropic 原生协议

使用 Anthropic 官方 SDK 或 Claude Code 时，只需把 base URL 指向 XycAi：

from anthropic import Anthropic

client = Anthropic(base_url="https://cn.chatapi.app", api_key="sk-xxxxxxxx")
msg = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello, Claude"}],
)
print(msg.content[0].text)

curl https://cn.chatapi.app/v1/messages \
  -H "x-api-key: sk-xxxxxxxx" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-5-5",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello, Claude"}]
  }'

四、流式输出

加上 "stream": true 即可以 Server-Sent Events 逐块接收响应。长任务（Agent、长文生成）建议一律使用流式，避免中间网络设备的空闲超时。

stream = client.chat.completions.create(
    model="gpt-5.6-terra",
    messages=[{"role": "user", "content": "写一首四行小诗。"}],
    stream=True,
)
for chunk in stream:
    print(chunk.choices[0].delta.content or "", end="", flush=True)

curl https://cn.chatapi.app/v1/chat/completions \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-5.6-terra", "messages": [{"role": "user", "content": "写一首四行小诗。"}], "stream": true}'

五、热门模型

同一个端点在不同厂商之间切换，只需修改 model 字段。以下是当前常用型号，完整目录见模型列表：

六、常见错误

请求失败时返回如下结构，message 末尾附带 request id，联系客服时请一并提供：

{
  "error": {
    "code": "",
    "message": "Invalid token (request id: 2026102212xxxx)",
    "type": "new_api_error"
  }
}

常见状态码：401 Key 无效，403 Key 无该模型 / 厂家权限（检查路由模式），429 并发超限或余额不足，400 请求参数错误，5xx 上游错误（自动重试后仍失败）。详见错误码。

七、下一步