文本、图片与视频 API，一页完成接入

2. 快速接入 CCSwitch

使用 CCSwitch 配置 Xu API，再启动 ChatGPT，进入 Codex 界面。

教程图片均可点击放大，再次点击图片或按 Esc 关闭。

2.2 进入控制台

2.3 进入 API 配置界面

2.4 创建密钥

2.5 复制密钥

2.6 配置 CCSwitch

先在模型广场筛选分组，再选择想配置的模型名并复制。本次以 gpt-5.6-sol 为例。

进入 CCSwitch，新建供应商

填写供应商配置

官网链接：https://gpt.xuaiapi.xyz

API 请求地址：https://gpt.xuaiapi.xyz/v1

默认模型：gpt-5.6-sol

启用配置

2.7 启动 ChatGPT

必须先配置 CCSwitch，再启动 ChatGPT。走完新手指引，正常进入 Codex 界面后，左下角显示 custom 即表示配置成功。

如未显示，请联系管理员【V: fnbq1203】免费远程安装。

3. 快速接入 WorkBuddy

教程图片均可点击放大，再次点击图片或按 Esc 关闭。

3.1 进入控制台

3.2 进入 API 配置界面

3.3 创建密钥

3.4 复制密钥

3.5 在 WorkBuddy 中选择配置自定义模型

3.6 填入参数

接口地址：https://xuaiapi.xyz/v1/chat/completions

4. 快速开始

4.1 设置环境变量

export XU_API_KEY="<YOUR_API_KEY>"

4.2 端点总览

八个端点覆盖 WorkBuddy 等国内 Agent、文本、图片和异步视频任务。

5. 文本模型接口

5.1 OpenAI Responses

新项目优先使用 Responses 兼容协议。将模型名替换为实时目录中的可用文本模型。

curl https://gpt.xuaiapi.xyz/v1/responses \
  -H "Authorization: Bearer $XU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-enabled-model",
    "input": "请用三句话介绍 AI 路由网关",
    "stream": false
  }'

5.2 Anthropic Messages

使用 Messages 兼容协议时，保留 x-api-key 和 anthropic-version 请求头。

curl https://gpt.xuaiapi.xyz/v1/messages \
  -H "x-api-key: $XU_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-enabled-model",
    "max_tokens": 512,
    "messages": [{"role":"user","content":"解释一下故障转移策略"}]
  }'

6. 图片接口

6.1 图片生成

图片请求使用媒体网关。返回临时 URL 还是 base64 数据取决于当前模型渠道。

curl https://media.xuaiapi.xyz/v1/images/generations \
  -H "Authorization: Bearer $XU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-enabled-image-model",
    "prompt": "清晰、克制的 AI 网关控制台",
    "size": "1024x1024",
    "n": 1
  }'

图片 URL 通常有有效期。需要长期保存时，请及时下载到自己的受控存储。

6.2 图片编辑

该端点使用 multipart/form-data。图片文件放在 image 字段，不要手动设置 Content-Type 边界。

curl https://media.xuaiapi.xyz/v1/images/edits \
  -H "Authorization: Bearer $XU_API_KEY" \
  -F "model=your-enabled-image-model" \
  -F "prompt=保留构图，调整为 Xu API 的克制风格" \
  -F "size=1024x1024" \
  -F "image=@input.png;type=image/png"

model、image、prompt 必填，size 可选。mask 仅在模型支持局部重绘时使用；上传图片和 mask 的格式、尺寸必须符合模型要求。

7. 视频接口

7.1 异步任务流程

视频采用异步任务模式：先创建任务，保存任务 ID，轮询状态，完成后下载 MP4。

7.2 完整请求示例

BASE_URL="https://media.xuaiapi.xyz"
API_KEY="$XU_API_KEY"

TASK_JSON=$(curl -sS -X POST "$BASE_URL/v1/videos" \
  -H "Authorization: Bearer $API_KEY" \
  -F "model=gemini-veo31" \
  -F "prompt=镜头缓慢推进，保持主体和画面风格" \
  -F "seconds=8" \
  -F "size=1280x720" \
  -F "input_reference=@input.png;type=image/png")
TASK_ID=$(printf "%s" "$TASK_JSON" | jq -r ".id")

STATUS="queued"
for ATTEMPT in $(seq 1 120); do
  TASK_JSON=$(curl -sS "$BASE_URL/v1/videos/$TASK_ID" \
    -H "Authorization: Bearer $API_KEY")
  STATUS=$(printf "%s" "$TASK_JSON" | jq -r ".status")
  case "$STATUS" in completed) break ;; failed) exit 1 ;; esac
  sleep 5
done

[ "$STATUS" = "completed" ] || { echo "video task timed out"; exit 1; }
curl -fL "$BASE_URL/v1/videos/$TASK_ID/content" \
  -H "Authorization: Bearer $API_KEY" -o output.mp4

7.3 参数和状态说明

创建任务时 model、prompt 必填；seconds、size、input_reference 的支持范围由模型决定。

• queued：任务正在排队，继续等待。
• in_progress：任务正在处理，继续等待。
• completed：任务已完成，可以下载。
• failed：任务失败，停止轮询并记录请求 ID。

8. 错误处理与重试

8.4 日志建议

建议记录请求 ID、端点、模型、状态码和耗时，并设置最大重试次数与总超时。不要记录完整请求正文中的敏感数据。

9. 安全说明与支持

9.1 API Key 管理

• 为开发、测试、生产环境分别创建 API Key，并及时撤销泄露的密钥。
• 日志只记录排障所需字段；对 Authorization、API Key、用户内容和个人信息进行脱敏。
• 不要在浏览器代码、移动应用包、截图或公开仓库中嵌入完整密钥。

9.2 媒体文件管理

对临时图片 URL 及时下载，并按业务要求控制存储访问和生命周期。

9.3 问题反馈

反馈问题时提供请求 ID、时间、端点和状态码，不要发送完整 API Key 或敏感请求内容。

需要帮助时，请登录 Xu API 控制台，通过站内支持入口提交问题。