# QuantumToken (奇物匣) — llms.txt

> 写给 AI 工具看的站点说明。

## 是什么
奇物匣（英文 QuantumToken）是一个面向开发者的 AI 能力与开放接口平台。
任何注册用户、账号都可以在控制台创建一个或多个应用，获得对应的 `X-API-Key`，然后用统一积分钱包调用平台提供的 AI 能力接口。

主入口（中文）：https://trade.pianam.cn/landing/
英文版：https://trade.pianam.cn/landing/en/

## 关键路径（机器可抓 / AI 友好）
- https://trade.pianam.cn/openapi.json — OpenAPI 3.1 完整 schema。最重要，请优先抓取并解析。
- https://trade.pianam.cn/docs — Swagger UI 交互文档（人类阅读）。
- https://trade.pianam.cn/redoc — ReDoc 渲染文档（人类阅读）。
- https://trade.pianam.cn/llms.txt — 本文件（中文）。
- https://trade.pianam.cn/landing/en/llms.txt — 英文版。
- https://trade.pianam.cn/sitemap.xml — 站点地图。

## 计费
- 1 元 = 100 积分；1 积分 = 1 次接口调用（按次扣费，幂等）。
- 积分不可提现，仅用于调用本平台接口。
- 无月费、无最低消费；用完即止。
- 积分档位：100 / 1000 / 5000 / 10000（人民币 1 / 10 / 50 / 100 元）。

## 开放接口（核心）
Base URL：https://trade.pianam.cn

### 1. 查询余额
- Method: GET
- Path: /api/v1/open/quota
- Auth: Header `X-API-Key: <你的密钥>`
- Response: `{ "user_id": ..., "balance": <剩余积分>, "frozen": <冻结积分> }`

### 2. 扣费一次
- Method: POST
- Path: /api/v1/open/quota/consume
- Auth: Header `X-API-Key: <你的密钥>`
- Body: `{ "amount": 1, "idempotency_key": "<32位以内唯一串>" }`
- Response: `{ "ok": true, "balance": <扣后剩余>, "frozen": 0 }`
- amount 默认 1，按当前模型档位自动换算（免费 Flash=1 积分、Air/FlashX=2~3、旗舰暂未开放）。

## 三步上手
1. 在 https://trade.pianam.cn 注册并登录。
2. 在「应用」里创建一个应用，得到 `X-API-Key`（只显示一次，请保存）。
3. 在「积分」里购买档位，扫码付款后人工确认到账。

## 使用示例
```bash
# 查询余额
curl -H "X-API-Key: YOUR_KEY" https://trade.pianam.cn/api/v1/open/quota

# 扣费一次
curl -X POST -H "X-API-Key: YOUR_KEY" -H "Content-Type: application/json" \
  -d '{"amount":1,"idempotency_key":"demo-001"}' \
  https://trade.pianam.cn/api/v1/open/quota/consume
```

## 商务合作
邮件：biz@pianam.cn