开发者接入

平台上的全部能力共用同一套调用约定。按次计费走 402 协议：未付费的调用返回账单，付款后携带凭证重试即取得结果，账单一一对应，便于对账。

调用流程

直接调用能力端点 —— 未付费会收到 402 与 Payment-Needed 账单头。
完成付款 —— 账单里给出能力标识、单价、账单号与支付时限。
携带凭证重试 —— 同一请求体附加 Payment-Proof，校验通过即返回业务结果。

接入所需信息

认证方式	`Authorization: Bearer <API_KEY>`
请求格式	`Content-Type: application/json`
计费协议	未付费返回 402，付费后返回结果
结算渠道	支付宝 AI 按量付费（AIPAY）／网页收银台
重试请求头	`Payment-Proof: <Base64URL 凭证>`
免费版端点	`POST /api/v1/<能力ID>/free`（部分检查项，无需付款与注册）
试用额度	`POST /api/v1/trial/claim` → 返回 token，之后用 `X-API-Token` 头调用
能力目录（机器可读）	/api/v1/capabilities
健康检查	/api/v1/health

示例请求

# 1) 首次调用：收到 402 与账单
curl -i -X POST https://www.tokendidi.cn/api/v1/quote-audit \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"items":[{"name":"混凝土","qty":100,"price":130,"amount":12000}]}'

# 2) 付款后携带凭证重试：返回业务结果
curl -X POST https://www.tokendidi.cn/api/v1/quote-audit \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Payment-Proof: <Base64URL 凭证>" \
  -H "Content-Type: application/json" -d '{"items":[...]}'

# 3) 免费版：不需要付款与注册
curl -X POST https://www.tokendidi.cn/api/v1/quote-audit/free \
  -H "Content-Type: application/json" -d '{"items":[...]}'

价格档位

一个档位 = 一个可计费资源，能力挂在档位上。

档位	端点	承载能力
加载中…

结果可复算

全部结果为确定性机械校验：同一输入必得同一输出，可被第三方按同一口径复算。这一点对集成方尤其重要——你可以在自己的测试里断言输出。

订阅 / 买断凭证（X-License）

除了按次付费，还有一条路：在有效期内不限次调用某个能力。请求时加一个头即可—— 成功调用走完整规则库且 charged:false（不扣按次额度）。

X-License: TKD1-<载荷>-<签名>

curl -s https://www.tokendidi.cn/api/v1/<能力id> \
  -H 'content-type: application/json' \
  -H 'X-License: TKD1-<载荷>-<签名>' \
  -d '{"text":"……"}'

凭证带能力 id（拿 A 能力的凭证调 B 能力会被拒）、有效期（订阅按 31 天一个周期换发）。凭证无效时返回 401 与具体原因（license_expired 等）， 不会给你任何结论；没有凭证的请求原样走按次付费路径，不受影响。凭证等同于长期付款凭据，请勿写进公开日志或前端代码。

需要 API Key？

目前按次调用使用支付宝结算，API_KEY 的批量发放与额度管理正在开发中。如果你要接入，请先通过工作台熟悉能力与入参，或在页面底部留下联系方式，开放后我们会通知你。