API 服务正常运行

虾盘云 API 开发文档

虾盘云提供 OpenAI 兼容接口，接入 DeepSeek、Qwen 等主流模型。本文档适合 AI 开发者快速接入，也方便 AI 自动读取。

更新时间：2026-04-06

基本信息

项目值
API 端点https://api.u-claw.org/v1
接口格式兼容 OpenAI（/v1/chat/completions 等）
认证方式Authorization: Bearer <your-key>
Key 前缀sk-xp-
计费单位quota（500,000 quota = $1 = ¥7.2）
汇率1 USD = 7.2 CNY（固定）
最低充值¥10

认证方式

所有请求需在 HTTP Header 中携带 API Key：

http
Authorization: Bearer sk-xp-your-key-here
⚠️

注意：Key 需先充值激活才能使用。未激活的 Key 调用接口会返回「无效的令牌」错误。

支持模型

model ID对应模型输入价格输出价格特点
deepseek-chatDeepSeek V3¥3 / 百万 token¥9 / 百万 token综合能力强，推荐首选
deepseek-reasonerDeepSeek R1¥12 / 百万 token¥36 / 百万 token深度推理，复杂逻辑
qwen-turbo通义千问 Turbo¥1.8 / 百万 token¥5.4 / 百万 token极速响应，高频场景
qwen-plus通义千问 Plus¥4 / 百万 token¥12 / 百万 token中文优化，长文档

对话接口

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

完全兼容 OpenAI chat/completions 接口格式，直接替换 baseUrl 即可。

请求示例

bash (curl)
curl https://api.u-claw.org/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xp-your-key-here" \
  -d '{
    "model": "deepseek-chat",
    "messages": [{"role": "user", "content": "你好"}],
    "stream": false
  }'
javascript
const res = await fetch('https://api.u-claw.org/v1/chat/completions', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer sk-xp-your-key-here'
  },
  body: JSON.stringify({
    model: 'deepseek-chat',
    messages: [{ role: 'user', content: '你好' }]
  })
});
const data = await res.json();
console.log(data.choices[0].message.content);
python
from openai import OpenAI

client = OpenAI(
    api_key="sk-xp-your-key-here",
    base_url="https://api.u-claw.org/v1"
)

response = client.chat.completions.create(
    model="deepseek-chat",
    messages=[{"role": "user", "content": "你好"}]
)
print(response.choices[0].message.content)

余额查询接口

GET https://api.u-claw.org/v1/dashboard/billing/subscription

返回该 Key 的总充值额度（USD）。

返回字段

字段类型说明
hard_limit_usdnumber累计充值总额（USD）
soft_limit_usdnumber同上（兼容字段）

返回示例

json
{
  "hard_limit_usd": 10.2,
  "soft_limit_usd": 10.2
}

用量查询接口

GET https://api.u-claw.org/v1/dashboard/billing/usage ?start_date=2020-01-01&end_date=2026-04-06

返回该 Key 在指定时间范围内的消耗量。

请求参数

参数类型说明
start_datestring开始日期 YYYY-MM-DD，建议填 2020-01-01
end_datestring结束日期 YYYY-MM-DD，建议填今天

返回字段

字段类型说明
total_usagenumber已消耗量，单位是 USD×100（分），除以100才是 USD

余额计算公式

formula
已消耗 USD = total_usage / 100
剩余 USD   = hard_limit_usd - 已消耗 USD
剩余 CNY   = 剩余 USD × 7.2

完整余额查询示例（JavaScript）

javascript
const API_BASE = 'https://api.u-claw.org/v1';

async function queryBalance(apiKey) {
  const headers = { Authorization: 'Bearer ' + apiKey };
  const today = new Date().toISOString().slice(0, 10);

  const [subRes, usageRes] = await Promise.all([
    fetch(`${API_BASE}/dashboard/billing/subscription`, { headers }),
    fetch(`${API_BASE}/dashboard/billing/usage?start_date=2020-01-01&end_date=${today}`, { headers })
  ]);

  if (!subRes.ok) throw new Error('Key 无效或未激活');

  const sub   = await subRes.json();
  const usage = await usageRes.json();

  const totalUsd  = sub.hard_limit_usd || 0;
  const usedUsd   = (usage.total_usage || 0) / 100;
  const remainUsd = totalUsd - usedUsd;

  return {
    totalCny:   (totalUsd  * 7.2).toFixed(2),  // 累计充值（CNY）
    usedCny:    (usedUsd   * 7.2).toFixed(2),  // 已消耗（CNY）
    balanceCny: (remainUsd * 7.2).toFixed(2),  // 剩余余额（CNY）
  };
}

// 使用示例
queryBalance('sk-xp-your-key-here').then(console.log);
// { totalCny: '73.44', usedCny: '1.36', balanceCny: '72.08' }

curl 测试

bash
KEY="sk-xp-your-key-here"

# 查询总充值额
curl https://api.u-claw.org/v1/dashboard/billing/subscription \
  -H "Authorization: Bearer $KEY"

# 查询已消耗
curl "https://api.u-claw.org/v1/dashboard/billing/usage?start_date=2020-01-01&end_date=$(date +%F)" \
  -H "Authorization: Bearer $KEY"

在线测试：实时查询余额

在这里直接输入你的 Key 测试接口是否正常返回数据。

🔬 余额查询测试

等待输入 Key...

充值流程

当前为手工充值模式，流程如下：

  1. 用户在网站生成或粘贴自己的 sk-xp- Key
  2. 支付宝扫码付款，付款备注填写 Key
  3. 管理员收到付款通知后，在 new-api 后台为该 Key 增加 quota
  4. 用户通过余额查询接口验证是否到账
ℹ️

工作时间 10 分钟内到账，非工作时间最长 2 小时。

Quota 换算

换算公式：quota = 充值CNY / 7.2 × 500,000

充值金额（CNY）增加 quota约等于（USD）
¥10694,444$1.39
¥201,388,888$2.78
¥503,472,222$6.94
¥1006,944,444$13.89

Key 格式

虾盘云 Key 格式：sk-xp- + 32位十六进制随机字符串（共 38 字符）

示例
sk-xp-fa3daa78e448871d6ccbffd1540cc07b
⚠️

重要：前端生成的 Key 仅是字符串，未在系统中注册。用户付款备注此 Key 后，管理员在 new-api 后台以此名创建 Token，Key 才真正激活生效。

前端生成 Key（JavaScript）

javascript
function generateKey() {
  const hex = Array.from(crypto.getRandomValues(new Uint8Array(16)))
    .map(b => b.toString(16).padStart(2, '0')).join('');
  return 'sk-xp-' + hex;
}

generateKey();
// => "sk-xp-fa3daa78e448871d6ccbffd1540cc07b"
✅

接口测试通过（2026-04-06）：余额查询接口实测返回正常，hard_limit_usd 和 total_usage 字段均可用。

虾盘云 · 首页 · 联系我们 · © 2026 api.u-claw.org