创建计费套餐版本

POST

/v1/admin/billing/plans/{planId}/versions

创建含币种、单价、额度和限流参数的草稿版本；激活后价格字段不可修改。

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Path 参数

Body 参数application/json必填

示例

{
    "currency": "CNY",
    "pricePerTurnMinor": 250,
    "includedTurns": 1000,
    "sustainedTurnsPerMinute": 60,
    "burstTurns": 10,
    "overagePolicy": "allowAndBill",
    "metadata": {
        "market": "cn"
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/v1/admin/billing/plans//versions' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "currency": "CNY",
    "pricePerTurnMinor": 250,
    "includedTurns": 1000,
    "sustainedTurnsPerMinute": 60,
    "burstTurns": 10,
    "overagePolicy": "allowAndBill",
    "metadata": {
        "market": "cn"
    }
}'

返回响应

🟢201

application/json

已创建的套餐草稿版本。

Bodyapplication/json

示例

{
    "id": "id_example",
    "planId": "plan_example",
    "revision": 1,
    "status": "draft",
    "currency": "CNY",
    "pricePerTurnMinor": 0,
    "includedTurns": 0,
    "sustainedTurnsPerMinute": 1,
    "burstTurns": 1,
    "overagePolicy": "block",
    "metadata": {}
}

🟠400BadRequest

🟠401Unauthorized

🟠403Forbidden

🟠404NotFound

🟠409Conflict

修改于 2026-09-27 15:11:45

创建计费套餐

激活计费套餐版本