虾盘云 API 开发文档

虾盘云是全球大模型聚合中转站 —— 一个 Key 调遍全球模型。完全兼容 OpenAI 接口,支持 GPT、Claude、Gemini、DeepSeek、Qwen 及图像/视频模型。任何支持自定义 baseUrl 的工具(OpenClaw、Claude Code、Codex、Cherry Studio、沉浸式翻译…)都能直接接入。本文档面向开发者与 AI 工具,5 分钟完成对接。

基本信息

认证方式

所有请求在 HTTP 头里带上你的 API Key:

Authorization: Bearer sk-你的Key

Key 在控制台「令牌管理 → 添加令牌」创建,或在官网充值页一键生成。三种格式都可用,详见 Key 格式。

支持模型

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

🟢 OpenAI / GPT

🟣 Anthropic / Claude

🔵 Google / Gemini

🟡 DeepSeek(国产高性价比)

🟠 通义千问 / 其他大模型

🎨 图像 / 视频生成

对话接口 (Chat Completions)

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

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)

设 "stream": true,响应以 SSE(data: 行)逐块返回,与 OpenAI 完全一致。Node/Python SDK 直接支持。

图像生成 (Images)

用 gpt-image-2 等图像模型作图,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"
  }'

余额查询

兼容 OpenAI 的 dashboard 计费接口,可查总额度与已用量:

下方 在线查余额 可直接粘贴 Key 实时测试。

接入 Claude Code

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(或 Codex 配置里指定的 env)。

Cherry Studio / 翻译 / 其他工具

任何支持自定义 OpenAI baseUrl 的工具都能接入,统一填:

已验证可用:OpenClaw、Cherry Studio、Cursor、沉浸式翻译、Bob 翻译、ChatBox、NextChat 等。OpenClaw / 虾盘 U 盘出厂已预装本地址,注册后填入 Key 即用。

如何充值

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

方式一:控制台在线充值(注册用户)

登录 控制台 →「钱包管理」→ 选金额(¥10/20/50/100…)→ 支付宝扫码 → 秒到账到你的账户余额。

方式二:官网充值页(U 盘用户 / 免注册)

打开 充值页 → 粘贴或生成你的 Key → 选金额 → 支付宝付款 → 按 Key 秒到账。适合虾盘 U 盘即插即用场景。

计费与 Quota

内部以 quota 计量,换算固定:

每次调用实际扣费 = 模型倍率 × token 数,不同模型单价不同(DeepSeek 最便宜,旗舰模型较高)。具体倍率见「模型广场」。按量计费、用多少扣多少。

Key 格式

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

在线查余额

粘贴你的 Key,实时调用余额接口(数据直连 api.u-claw.org,不经第三方):

常见错误

FAQ

和直接用官方有什么区别?

统一入口、人民币充值、一个 Key 调遍 GPT/Claude/Gemini/国产模型,无需逐家注册海外账号。对国内用户更友好,配合虾盘 U 盘开箱即用。

余额会过期吗?

不会。按量充值,余额永久有效,用多少扣多少。

支持哪些接口?

OpenAI 兼容(chat/completions、images/generations、embeddings、models)+ Anthropic 兼容(Claude Code)。绝大多数 OpenAI 生态工具开箱即用。

付款后多久到账?

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

遇到问题?控制台站内工单,或微信 hecare888 · 官网 cloud.u-claw.org