估算剧情选项价格 · Calculate Plot Options Price

根据要生成的剧情选项条数，估算一次 对话选项生成 预计消耗的钻石（credits）。常用于在生成前给用户预览本次扣费。

该接口只做计算、不产生扣费，返回的是「单次生成」的预估价格。

接口地址

POST https://xiangcao.ai/api/calculate-plot-options-price

该接口为普通接口，使用 POST 方法。

鉴权

需要在请求头携带 API Key：

Authorization: Bearer <YOUR_API_KEY>

缺少或无效的 Token 会返回 401。

请求体（JSON）

类型定义（TypeScript）

interface CalculatePlotOptionsPriceRequest {
  /** 剧情选项条数，整数 3-10 */
  plotOptionsCount: number;
}

响应（JSON）

interface CalculatePlotOptionsPriceResponse {
  /** 单次生成预计消耗的钻石（credits）总数 */
  estimatedTotalPrice: number;
}

计费说明

价格单位为钻石（credits），随选项条数增加而提高。当前各条数的价格参考如下（请以接口返回的 estimatedTotalPrice 为准）：

示例

请求：

curl -X POST "https://xiangcao.ai/api/calculate-plot-options-price" \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "plotOptionsCount": 4
  }'

响应：

{
  "estimatedTotalPrice": 140
}

错误处理

出错时返回相应 HTTP 状态码及 JSON：{ "error": "..." }。