跳到主要内容

钱包购买订阅

POST /api/subscription/wallet/pay

使用钱包额度购买指定订阅套餐。需提供幂等键以避免重复扣费。

鉴权说明

用户控制台接口,需登录用户身份(会话 Cookie,或 Authorization: Bearer <access_token>)。此令牌与模型调用使用的 sk- 密钥不同。

请求体参数​

参数名类型必选说明
plan_idinteger必选订阅套餐 ID,必须大于 0
idempotency_keystring必选幂等键,防止重复扣费
请求示例
{
"plan_id": 1,
"idempotency_key": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}

响应字段(200)​

字段名类型说明
successboolean是否成功
messagestring提示信息
dataobject购买结果(订阅详情)
相关订阅支付接口
  • 免费套餐领取:POST /api/subscription/free/pay,请求体 { "plan_id": <整数> }
  • 钱包续费:POST /api/subscription/wallet/renew,请求体 { "subscription_id": <整数>, "idempotency_key": <字符串> }
  • 支付宝充值(属于充值模块,非订阅):POST /api/user/alipay/pay