跳转到正文Skip to content

Embedded 自助服务 API

终端使用 token exchange 返回的短期 Bearer 令牌访问固定 Application 下的 /api/v1/apps/{app}/users/me/*。不要让终端提交任意用户 ID,也不要把 AppClient secret 用在这些请求中。

能力方法与路径
当前权益GET /api/v1/apps/{app}/users/me/entitlements
余额GET /api/v1/apps/{app}/users/me/wallet
交易记录GET /api/v1/apps/{app}/users/me/transactions
用量GET /api/v1/apps/{app}/users/me/usage
订单GET/POST /api/v1/apps/{app}/users/me/orders
个人账单GET /api/v1/apps/{app}/users/me/statements
支持工单/api/v1/apps/{app}/users/me/support/tickets*

创建订单时为同一次业务操作复用 UUID Idempotency-Key。返回的支付意图不是付款成功凭证;最终状态以随后查询到的订单结果为准。

游标是不可解析的不透明字符串。把 next_cursor 原样传回 cursor,并遵守 has_more。金额、Credits、余额和费率使用十进制字符串;展示时保留服务端精度,计算时使用十进制定点库。

数据 API 使用相同短期 Bearer 令牌时,可调用已授权的 /v1/chat/completions/v1/balance/v1/usage 等入口。可用能力以当前权益与 /v1/models 返回结果为准。