开放 API 文档
返回平台 →

开放 API 文档

版本 v1 · 最后更新 2026-09-19
快速开始 鉴权 接口列表 错误码 示例代码 频率限制

🚀 快速开始

  1. 登录平台，进入顶部导航 🔑 API
  2. 点【生成密钥】，选择权限（只读 或 读写）
  3. 立即复制保存（密钥只显示一次）
  4. 在所有请求带上请求头 X-API-Key: 你的密钥
⚠️ 密钥等同于你的账号权限，请勿泄露给他人或提交到公开仓库。

🔐 鉴权

所有 v1 接口通过请求头鉴权：

X-API-Key: qk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

权限范围（scopes）

细粒度权限（11 项）

scope名称说明
me:read读取账号信息积分 / Token / 会员 / 容器位
bots:read读取 Bot查看列表与详情
bots:control启停 Bot启动 / 暂停
bots:write增删改 Bot创建 / 编辑 / 删除（高危）
usage:read读取用量Token 用量统计
tiers:read读取价格商品档位价格
token:buy购买 Token会扣积分
slot:buy购买容器位会扣积分
vip:buy购买 Pro 会员会扣积分
files:read读取工作区浏览 / 下载文件
files:write修改工作区上传 / 删除 / 新建（高危）

预设组合

预设包含
只读me:read · bots:read · usage:read · tiers:read
仅监控me:read · bots:read · usage:read
交易只读 + token:buy · slot:buy · vip:buy
全部11 项全部
兼容：旧的 read / trade 密钥仍可用
基础地址：https://qbot.hi0357.com

📚 接口列表

GET /api/v1/me
查询账号信息（积分 / Token / 会员 / 容器位）· 需 read
{
  "ok": true,
  "user": { "id": 1008, "name": "exp114514", "points": 500 },
  "points_human": "500",
  "wallet": { "tokens": 0, "tokens_human": "0",
              "used_today": 0, "daily_limit": 10000000 },
  "vip": false,
  "slots": 1
}
GET /api/v1/bots
列出我的所有 Bot · 需 read
{
  "ok": true, "count": 1,
  "bots": [ { "id": 4, "name": "awa", "status": "running",
              "appid": "1905623965", "port": 20004,
              "tokens_used": 6994, "tokens_used_human": "6.994K" } ]
}
status 取值：running 运行中 / stopped 已暂停 / deploying 部署中 / error 异常 / stopped_no_token 余额不足已停 / stopped_daily_limit 超日限已停
GET /api/v1/bots/{id}
查询单个 Bot 详情 · 需 read
GET /api/v1/usage?days=7
Token 用量统计（按天）· 需 read · days 范围 1~90
{
  "ok": true,
  "usage": [ { "day": "2026-09-18", "tokens": 120000,
               "calls": 3, "tokens_human": "120K" } ]
}
GET /api/v1/tiers
商品档位与价格 · 无需鉴权
{
  "ok": true,
  "tokens": [ { "tokens": 100000, "points": 1 },
              { "tokens": 1000000, "points": 5 }, ... ],
  "slot_price": 100,
  "vip": { "vip": {"months":1,"points":230},
           "vip_quarter": {"months":3,"points":655},
           "vip_year": {"months":12,"points":2300} }
}
POST /api/v1/buy
代下单（真实扣积分）· 需 trade 权限
POST /api/v1/buy
Content-Type: application/json
X-API-Key: qk_xxx

{ "kind": "token", "tokens": 1000000, "qty": 2 }
kind参数说明
tokentokens, qty买 Token（VIP 自动 9 折）
slotqty买容器位（最多再买 9 个）
vipqtyPro 会员 · 月费 230 分
vip_quarterqtyPro 会员 · 季费 655 分
vip_yearqtyPro 会员 · 年费 2300 分
{ "ok": true, "subtotal": 10, "paid": 9.0, "qty": 2 }
POST /api/v1/bots/{id}/start
启动 Bot · 需 bots:control
{ "ok": true, "bot_id": 4, "status": "running" }
POST /api/v1/bots/{id}/stop
暂停 Bot · 需 bots:control
GET /api/v1/bots/{id}/files?path=
列出工作区文件 · 需 files:read
{ "ok": true, "path": "", "items": [
  { "name": "config", "is_dir": true, "size": 0 },
  { "name": "readme.txt", "is_dir": false, "size": 128 } ] }
GET /api/v1/bots/{id}/files/download?path=
下载文件 · 需 files:read
POST /api/v1/bots/{id}/files/upload?path=
上传文件（multipart/form-data，字段名 file）· 需 files:write · 单文件 ≤200MB · 工作区 ≤5GB
DELETE /api/v1/bots/{id}/files?path=
删除文件/目录 · 需 files:write
POST /api/v1/bots/{id}/files/mkdir?path=
新建目录 · 需 files:write

⚠️ 错误码

HTTP说明
400参数错误（档位不存在 / 数量非法）
401缺少或无效的 API Key
402积分不足
403权限不足（如没 trade 权限却调用购买）/ 超出容器位上限
404资源不存在
429请求过于频繁
500服务器内部错误
{ "detail": "积分不足" }

💻 示例代码

cURL

curl -H "X-API-Key: qk_xxx" \
     https://qbot.hi0357.com/api/v1/me

Python

import requests

KEY = "qk_xxx"
BASE = "https://qbot.hi0357.com"
H = {"X-API-Key": KEY}

# 查询账号
me = requests.get(f"{BASE}/api/v1/me", headers=H).json()
print("积分:", me["points_human"], "| Token:", me["wallet"]["tokens_human"])

# 列出 Bot
for b in requests.get(f"{BASE}/api/v1/bots", headers=H).json()["bots"]:
    print(b["id"], b["name"], b["status"], b["tokens_used_human"])

# 买 2 份 1M Token（需要 trade 权限）
r = requests.post(f"{BASE}/api/v1/buy", headers=H,
                  json={"kind": "token", "tokens": 1000000, "qty": 2})
print(r.json())

JavaScript (fetch)

const BASE = "https://qbot.hi0357.com";
const H = { "X-API-Key": "qk_xxx" };

const me = await (await fetch(`${BASE}/api/v1/me`, { headers: H })).json();
console.log("积分:", me.points_human);

const bots = await (await fetch(`${BASE}/api/v1/bots`, { headers: H })).json();
console.log("Bot 数:", bots.count);

🚦 频率限制

安全建议

📞 联系我们

问题反馈：平台 · 或到 MeteorWorld 社区提问