xucu.app

API Documentation

兼容 OpenAI / Anthropic SDK，直接替换 base URL。

POST /v1/messages

Anthropic Messages API，支持 Claude 全系列模型。

curl -X POST https://api.xucu.app/v1/messages \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-sonnet-4-5-20250514",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello"}]
  }'

POST /v1/responses

OpenAI Responses API，支持 GPT 全系列模型。

curl -X POST https://api.xucu.app/v1/responses \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-5.4", "input": "Hello"}'

GET /v1/models

查询可用模型列表。

curl -H "x-api-key: YOUR_API_KEY" \
  https://api.xucu.app/v1/models

接入教程

API 信息

认证: x-api-key: sk-xxx 或 Authorization: Bearer sk-xxx

端点: Claude 系列 → POST /v1/messages | GPT 系列 → POST /v1/responses | 模型列表 → GET /v1/models

可用模型: claude-opus-4-6 · claude-opus-4-6-fast · claude-sonnet-4-6 · claude-haiku-4-5 · gpt-5.3-codex · gpt-5.4 · gpt-5.4-mini

不支持 /v1/chat/completions。Claude 走 /v1/messages，GPT 走 /v1/responses。

Claude Code (终端)

设置环境变量 (加到 ~/.bashrc 或 ~/.zshrc):

export ANTHROPIC_BASE_URL=https://api.xucu.app
export ANTHROPIC_API_KEY=sk-xxx

Windows PowerShell:

$env:ANTHROPIC_BASE_URL = "https://api.xucu.app"
$env:ANTHROPIC_API_KEY = "sk-xxx"

启动后输入 /model 选择模型 (如 claude-opus-4-6).

Claude Code (VS Code 扩展)

1. 扩展市场搜索 Claude Code (ID: anthropic.claude-code), 安装.

2. VS Code settings.json 配终端环境变量:

{
  "terminal.integrated.env.windows": {
    "ANTHROPIC_BASE_URL": "https://api.xucu.app",
    "ANTHROPIC_API_KEY": "sk-xxx"
  }
}

3. 打开 Claude Code 面板, 输入 /model 选择模型.

OpenCode

编辑 opencode.json (项目根目录或 ~/.config/opencode/):

{
  "provider": {
    "xucu": {
      "npm": "@ai-sdk/anthropic",
      "options": {
        "baseURL": "https://api.xucu.app/v1",
        "apiKey": "sk-xxx"
      },
      "models": {
        "claude-opus-4-6": {
          "name": "Claude Opus 4.6",
          "attachment": true, "reasoning": true, "tool_call": true,
          "limit": { "context": 1000000, "output": 64000 }
        }
      }
    }
  }
}

Cursor

1. Cursor Settings → Models.

2. Anthropic API Key 填: sk-xxx

3. 开启 Override Anthropic Base URL, 填: https://api.xucu.app

4. 选 claude 系列模型使用.

Cursor Anthropic 模式走 x-api-key + /v1/messages, 和网关兼容.

Cherry Studio

Claude 系列

设置 → 模型服务商 → Anthropic → API 地址: https://api.xucu.app, API Key: sk-xxx, 点"获取模型".

GPT 系列

添加自定义服务商 (OpenAI 类型) → API 地址: https://api.xucu.app, 手动添加模型: gpt-5.4 等.

OpenClaw