# 虾盘云 (Xiapan Cloud) AI API — 完整接入文档

> 本文件为 AI 可读全文语料(llms-full.txt)。虾盘云是全球大模型聚合中转站:一个 API Key 调遍全球模型,完全兼容 OpenAI 接口,同时兼容 Anthropic 接口。人民币充值,按 token 计费,余额永久有效。
> 最后更新:2026-06-16

================================================================
## 1. 基本信息
================================================================

- 服务名称:虾盘云 AI API 分发平台
- API 端点(主):https://api.u-claw.org/v1
- Anthropic 端点(仅 Claude Code,不带 /v1):https://api.u-claw.org
- 接口格式:兼容 OpenAI Chat Completions / Images / Embeddings / Models;兼容 Anthropic Messages
- 计费:按 token 计费,¥1 = 500,000 token(50 万),余额永久有效,无月费
- 充值:支付宝在线充值,秒到账
- 官网:https://cloud.u-claw.org
- 支持工具:OpenClaw、U-Hermes、Claude Code、Codex、Cherry Studio、Cursor、ChatBox、NextChat、沉浸式翻译、Bob 翻译 等任何兼容 OpenAI 接口的工具

================================================================
## 2. 统一接入参数
================================================================

几乎所有 AI 工具都只需这两项:

- Base URL / API 地址:https://api.u-claw.org/v1
- API Key:形如 sk-... (在控制台「令牌管理」创建,或官网充值页生成)

Claude Code 例外:它走 Anthropic 原生端点,Base URL 用 https://api.u-claw.org(不带 /v1)。

================================================================
## 3. API Key 格式
================================================================

三种格式都能查余额、调 API,后端统一识别:

| 格式             | 来源                                   |
|------------------|----------------------------------------|
| sk- + 48位       | 控制台「令牌管理」创建(字母数字)      |
| sk-xp- + 64位    | 官网充值页生成 / 手动注册(十六进制)   |
| sk-uc- + 64位    | 虾盘 U 盘 / OpenClaw 开源版(设备指纹) |

认证方式:HTTP 头 `Authorization: Bearer sk-你的Key`

================================================================
## 4. 支持的模型(model ID)
================================================================

直接把 model ID 填进请求即可。模型持续更新,以控制台「模型广场」为准。

### OpenAI / GPT
| model ID        | 说明                          |
|-----------------|-------------------------------|
| gpt-5.4         | GPT-5.4 旗舰,最强通用与推理   |
| gpt-5.4-mini    | GPT-5.4 轻量版,快且便宜       |
| gpt-5.3-codex   | 代码专用(配 Codex 用)        |
| gpt-4o          | GPT-4o 多模态                 |
| gpt-image-2     | 图像生成/编辑                 |

### Anthropic / Claude
| model ID          | 说明                                      |
|-------------------|-------------------------------------------|
| claude-opus-4-6   | Claude Opus 4.6,最强 Claude               |
| claude-sonnet-4-6 | Claude Sonnet 4.6,均衡(配 Claude Code 推荐)|
| claude-haiku-4-5  | Claude Haiku 4.5,极速轻量                 |

### Google / Gemini
| model ID                   | 说明                       |
|----------------------------|----------------------------|
| gemini-3.1-pro-preview     | Gemini 3.1 Pro,超长上下文  |
| gemini-3-pro-image-preview | Gemini 3 图像理解/生成      |
| gemini-2.5-flash           | Gemini 2.5 Flash,快速      |

### DeepSeek(国产高性价比)
| model ID          | 说明                                   |
|-------------------|----------------------------------------|
| deepseek-v4-pro   | DeepSeek V4 Pro,旗舰                    |
| deepseek-v4-flash | DeepSeek V4 Flash,¥3 起,U 盘默认模型   |
| deepseek-chat     | 通用对话(透明路由到最新版)             |
| deepseek-reasoner | 深度推理                               |

### 通义千问 / 其他大模型
| model ID            | 说明                |
|---------------------|---------------------|
| qwen3.7-max         | 通义千问 3.7 Max     |
| qwen-plus / qwen-turbo | 通义千问 Plus / Turbo |
| kimi-k2.6           | 月之暗面 Kimi K2.6   |
| glm-5               | 智谱 GLM-5           |
| grok-4.3            | xAI Grok 4.3         |
| MiniMax-M3          | MiniMax M3           |

### 图像生成模型(画图,按张/次计费,价格为参考美元单价)
| model ID                       | 厂商             | 参考单价/张 |
|--------------------------------|------------------|-------------|
| gpt-image-2                    | OpenAI           | 按 token    |
| gemini-3-pro-image-preview     | Google Gemini    | 按 token    |
| seedream-4-5                   | 字节即梦 Seedream | $0.12       |
| seedream-4-0                   | 字节即梦 Seedream | $0.09       |
| doubao-seedream-4-0-250828     | 豆包 Seedream     | $0.055      |
| wan2.7-image-pro               | 通义万相 Wan      | $0.225      |
| wanx2.1-t2i-turbo              | 通义万相 Wan(最便宜)| $0.041   |

### 视频生成模型(按次计费,异步任务,价格为参考美元单价)
| model ID                              | 厂商                | 参考单价/次 |
|---------------------------------------|---------------------|-------------|
| veo-3.1-generate-001                  | Google Veo 3.1      | $1.2        |
| veo-3.1-fast-generate-001             | Google Veo 3.1 Fast | $0.24       |
| dreamina-seedance-2-0                 | 即梦 Seedance       | 按量        |
| doubao-seedance-1-0-pro-fast-251015   | 豆包 Seedance       | $0.548      |
| wanx2.1-t2v-turbo                     | 通义万相 Wan        | $0.411      |

注:以上为虾盘云 NewAPI 当前实际开通、客户可直接调用的画图/视频模型(数据取自 /api/pricing)。
价格随上游浮动,以控制台「模型广场」实时显示为准;model ID 拼写错误会返回 model not found。

================================================================
## 5. 对话接口 (Chat Completions)
================================================================

POST https://api.u-claw.org/v1/chat/completions

标准 OpenAI 格式,把 model 换成任意支持的 model ID 即可。

curl 示例:
  curl https://api.u-claw.org/v1/chat/completions \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer sk-你的Key" \
    -d '{
      "model": "deepseek-v4-flash",
      "messages": [{"role": "user", "content": "你好,介绍一下你自己"}],
      "stream": false
    }'

Python(openai SDK):
  from openai import OpenAI
  client = OpenAI(base_url="https://api.u-claw.org/v1", api_key="sk-你的Key")
  resp = client.chat.completions.create(
      model="claude-sonnet-4-6",
      messages=[{"role": "user", "content": "用一句话解释量子纠缠"}],
  )
  print(resp.choices[0].message.content)

流式输出:设 "stream": true,响应以 SSE(data: 行)逐块返回,与 OpenAI 完全一致。

================================================================
## 6. 图像生成 (Images)
================================================================

POST https://api.u-claw.org/v1/images/generations

OpenAI Images 接口格式:
  curl https://api.u-claw.org/v1/images/generations \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer sk-你的Key" \
    -d '{
      "model": "gpt-image-2",
      "prompt": "一只在霓虹城市里撑伞的赛博朋克龙虾,电影感",
      "n": 1,
      "size": "1024x1024"
    }'

换画图模型只改 model 字段,例如 "model":"seedream-4-5" / "wan2.7-image-pro" / "wanx2.1-t2i-turbo"(最便宜)/ "gemini-3-pro-image-preview"。
说明:不同图像模型支持的参数(尺寸 size、张数 n、质量 quality、参考图)略有差异。gpt-image-2 走 token 计费,即梦/万相系列按张计费。

视频接口(异步任务,三步):
  1. 提交:POST https://api.u-claw.org/v1/videos
     body: {"model":"veo-3.1-generate-001","prompt":"..."}(图生视频再带 image 字段)
  2. 轮询:GET https://api.u-claw.org/v1/videos/{task_id}  直到状态完成
  3. 取结果:GET https://api.u-claw.org/v1/videos/{task_id}/content
  可用视频 model:veo-3.1-generate-001 / veo-3.1-fast-generate-001 / dreamina-seedance-2-0 / doubao-seedance-1-0-pro-fast-251015 / wanx2.1-t2v-turbo
  具体参数(时长 duration、分辨率 resolution)以「模型广场」对应模型说明为准。

================================================================
## 7. 接入各类 AI 工具
================================================================

### OpenClaw / 虾盘 U 盘(出厂已预装本地址)
注册后把 Key 填进配置即可。手动配置时在 openclaw.json 加一个 provider:
  {
    "models": {
      "mode": "merge",
      "providers": {
        "xiapan": {
          "baseUrl": "https://api.u-claw.org/v1",
          "apiKey": "你的Key",
          "api": "openai-completions",
          "models": [{ "id": "deepseek-v4-flash" }, { "id": "claude-sonnet-4-6" }]
        }
      }
    }
  }

### U-Hermes(龙虾对话端)
设置 → 模型服务 → 选「OpenAI 兼容」,填:
  接口地址(Base URL): https://api.u-claw.org/v1
  API Key:            你的Key
  模型名:             deepseek-v4-flash(或任意 model ID)

### Claude Code(Anthropic 端点,不带 /v1)
  export ANTHROPIC_BASE_URL=https://api.u-claw.org
  export ANTHROPIC_AUTH_TOKEN=sk-你的Key
  claude
模型推荐 claude-sonnet-4-6(均衡)或 claude-opus-4-6(最强)。

### Codex
编辑 ~/.codex/config.toml:
  model = "gpt-5.3-codex"
  model_provider = "uclaw"
  [model_providers.uclaw]
  name = "虾盘云"
  base_url = "https://api.u-claw.org/v1"
  wire_api = "responses"
把 Key 设到环境变量 OPENAI_API_KEY=sk-你的Key。

### Cherry Studio / ChatBox / NextChat / Cursor / 沉浸式翻译等
任何支持自定义 OpenAI baseUrl 的工具,统一填:
  API 地址 / Base URL:https://api.u-claw.org/v1
  API Key:sk-你的Key
  模型:任意 model ID(如 deepseek-v4-flash)

================================================================
## 8. 余额查询
================================================================

兼容 OpenAI 的 dashboard 计费接口:

查剩余额度:
  GET https://api.u-claw.org/v1/dashboard/billing/subscription
  Authorization: Bearer sk-你的Key
  返回 hard_limit_usd:剩余额度(订阅接口返回的是剩余,不是总额)

查已用量:
  GET https://api.u-claw.org/v1/dashboard/billing/usage?start_date=2020-01-01&end_date=2026-12-31
  Authorization: Bearer sk-你的Key
  返回 total_usage:已消耗(单位 0.01,即除以 100 得额度单位)

================================================================
## 9. 充值与计费
================================================================

两种方式,余额永久有效,¥1 = 50 万 token:

方式一(控制台在线充值,注册用户):
  登录控制台 https://api.u-claw.org →「钱包管理」→ 选金额 → 支付宝扫码 → 秒到账到账户余额

方式二(官网充值页,U 盘用户 / 免注册):
  打开 https://api.u-claw.org/recharge → 粘贴或生成 Key → 选金额 → 支付宝付款 → 按 Key 秒到账

计费换算:
  ¥1   = 500,000 quota   = 50 万 token
  ¥10  = 5,000,000       = 500 万
  ¥100 = 50,000,000      = 5000 万
每次调用实际扣费 = 模型倍率 × token 数。DeepSeek 最便宜,旗舰模型较高。按量计费,用多少扣多少。
最低充值:¥10。

================================================================
## 10. 常见错误
================================================================

| 报错                                | 原因 / 解决                                          |
|-------------------------------------|------------------------------------------------------|
| invalid token / 无效的令牌          | Key 写错或未生效;确认 Bearer 前缀和完整 Key          |
| insufficient_user_quota / 额度不足  | 账户余额不够,去充值;充值后即恢复                    |
| token quota is not enough           | 该令牌设了额度上限,去控制台「令牌管理」调高或设无限   |
| model not found / 无可用渠道        | model ID 拼写错误,或该模型暂未开通;以模型广场为准    |
| 401 Unauthorized                    | 未带认证头,或 Key 已删除/禁用                        |

================================================================
## 11. FAQ
================================================================

Q: 和直接用官方有什么区别?
A: 统一入口、人民币充值、一个 Key 调遍 GPT/Claude/Gemini/国产模型,无需逐家注册海外账号。配合虾盘 U 盘开箱即用。

Q: 余额会过期吗?
A: 不会。按量充值,余额永久有效,用多少扣多少。

Q: 支持哪些接口?
A: OpenAI 兼容(chat/completions、images/generations、embeddings、models)+ Anthropic 兼容(Claude Code)。绝大多数 OpenAI 生态工具开箱即用。

Q: 付款后多久到账?
A: 支付宝在线充值,付款成功后系统自动入账,通常几秒内即可使用。

================================================================
## 12. 联系 / 支持
================================================================

- 微信:hecare888
- 官网:https://cloud.u-claw.org
- 控制台:https://api.u-claw.org