获取订阅套餐列表
GET /api/subscription/plans
获取当前用户可购买的订阅套餐列表(已按用户分组过滤,仅返回启用的套餐)。可传 id 查询指定套餐。
鉴权说明
用户控制台接口,需登录用户身份(会话 Cookie,或 Authorization: Bearer <access_token>)。此令牌与模型调用使用的 sk- 密钥不同。
Query 参数
| 参数名 | 类型 | 必选 | 说明 |
|---|---|---|---|
id | integer | 可选 | 套餐 ID,指定后仅返回该套餐 |
响应字段(200)
| 字段名 | 类型 | 说明 |
|---|---|---|
success | boolean | 是否成功 |
message | string | 提示信息 |
data | array<object> | 套餐列表,每个元素含 plan 字段 |
data[].plan | object | 套餐详情,结构见下方 ↳ 套餐对象 |
套餐对象(plan)字段
| 字段名 | 类型 | 说明 |
|---|---|---|
id | integer | 套餐 ID |
title | string | 套餐标题 |
subtitle | string | 套餐副标题 |
price_amount | number | 价格 |
currency | string | 货币单位(默认 USD) |
duration_unit | string | 有效期单位(默认 month) |
duration_value | integer | 有效期时长 |
custom_seconds | integer | 自定义有效期(秒) |
enabled | boolean | 是否启用 |
sort_order | integer | 排序值 |
stripe_price_id | string | Stripe 价格 ID |
creem_product_id | string | Creem 商品 ID |
max_purchase_per_user | integer | 每用户购买上限;0 表示不限 |
upgrade_group | string | 升级用户组 |
allowed_model_groups | array<string> | 允许的模型组 |
allowed_models | array<string> | 允许的模型 |
allowed_user_groups | array<string> | 允许的用户分组 |
total_amount | integer | 套餐总额度 |
total_limit_type | string | 总额度限制类型 |
total_limit_value | integer | 总额度限制值 |
entitlement_version | integer | 权益版本 |
period_limits | object | 周期额度限制 |
model_limits | array<object> | 模型额度限制 |
rate_rules | array<object> | 速率规则 |