跳到主要内容

获取订阅套餐列表

GET /api/subscription/plans

获取当前用户可购买的订阅套餐列表(已按用户分组过滤,仅返回启用的套餐)。可传 id 查询指定套餐。

鉴权说明

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

Query 参数​

参数名类型必选说明
idinteger可选套餐 ID,指定后仅返回该套餐

响应字段(200)​

字段名类型说明
successboolean是否成功
messagestring提示信息
dataarray<object>套餐列表,每个元素含 plan 字段
data[].planobject套餐详情,结构见下方
↳ 套餐对象
套餐对象(plan)字段
字段名类型说明
idinteger套餐 ID
titlestring套餐标题
subtitlestring套餐副标题
price_amountnumber价格
currencystring货币单位(默认 USD)
duration_unitstring有效期单位(默认 month)
duration_valueinteger有效期时长
custom_secondsinteger自定义有效期(秒)
enabledboolean是否启用
sort_orderinteger排序值
stripe_price_idstringStripe 价格 ID
creem_product_idstringCreem 商品 ID
max_purchase_per_userinteger每用户购买上限;0 表示不限
upgrade_groupstring升级用户组
allowed_model_groupsarray<string>允许的模型组
allowed_modelsarray<string>允许的模型
allowed_user_groupsarray<string>允许的用户分组
total_amountinteger套餐总额度
total_limit_typestring总额度限制类型
total_limit_valueinteger总额度限制值
entitlement_versioninteger权益版本
period_limitsobject周期额度限制
model_limitsarray<object>模型额度限制
rate_rulesarray<object>速率规则