预估积分

根据模型和当前生成参数返回预计积分，不创建任务，也不会扣除积分。

在创建图片或视频任务前调用此接口，可以展示当前参数组合的预计积分。报价会按当前 API Key 的模型权限、区域和用户组匹配正式售价规则。

报价请求使用与 POST /v1/generations 相同的扁平参数结构。为了保证预估准确，所有会影响售价匹配或用量的参数及其值都应与稍后创建任务时保持一致。

POST /v1/quote

请求参数

字段	类型	必填	说明
`model`	`string`	是	图片或视频模型 ID
`prompt`	`string`	否	报价时可省略；创建任务时仍按模型 schema 要求传入
`n`	`integer`	否	生成条数
`resolution`	`string`	否	分辨率，例如 `1K`、`2K`、`720p`
`aspect_ratio`	`string`	否	画面比例，例如 `1:1`、`16:9`
`duration`	`integer`	否	视频时长，单位秒
`quality`	`string`	否	仅模型 schema 声明时传入，例如 `gpt-image-2-official` 的 `low`、`medium`、`high`
`reference_images`	`string[]`	否	参考图片 URL；仅模型 schema 声明时传入
`reference_videos`	`string[]`	否	参考视频 URL；Seedance 2 系列最多 3 个，传入后可能启用视频输入计费
`input_video_duration`	`number`	否	实际处理的输入视频秒数；传 `reference_videos` 时建议同时传入，以获得准确报价
`reference_audios`	`string[]`	否	参考音频 URL；仅模型 schema 声明时传入，Seedance 2 系列最多 3 个
`generate_audio`	`boolean`	否	是否生成音频；仅模型 schema 声明时传入，Seedance 2 系列默认 `true`
`audio`	`boolean`	否	Kling 模型的生成音频开关；仅模型 schema 声明时传入
`mode`	`string`	否	Kling 生成档位，例如 `std`、`pro`、`4k`
`first_frame_image_url`	`string`	否	首帧图片 URL；仅模型 schema 声明时传入
`last_frame_image_url`	`string`	否	尾帧图片 URL；仅模型 schema 声明时传入

只需传入当前模型实际支持的参数。不要把前端内部接口 /api/playground/quote 的 { model, family, input } 包装结构用于对外 API；/v1/quote 和 /v1/generations 都使用上表所示的扁平结构。

最终扣费仍以创建任务时服务端重新匹配的规则为准。如果报价与创建任务所传的 n、resolution、quality、duration、参考视频或输入视频时长不同，两次结果可能不同。

Kling 的 mode、audio、参考视频和输入视频时长都可能影响报价，必须在 quote 与 generation 请求中保持一致。Gemini Omni Flash 当前只接受 duration=10。

示例

curl -X POST https://aibubu.cn/v1/quote \
  -H "Authorization: Bearer sk_yeehoo_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "n": 2,
    "resolution": "2K",
    "aspect_ratio": "1:1"
  }'

响应

{
  "model": "gpt-image-2",
  "family": "image",
  "estimated_credits": 22.4,
  "unit": "image",
  "charge_type": "per_image",
  "matched_rule_id": "team_gpt_image_2_2k",
  "pricing_version": "<sha256>"
}

estimated_credits 是本次请求的总积分。上例为 2K 单张 11.2 积分、n=2 共 22.4 积分；不要再乘一次 n。报价和实际创建任务会分别重新匹配当前生效规则。

不要给不支持该参数的模型传 quality；例如普通版 gpt-image-2 不支持质量参数，官方版 gpt-image-2-official 才支持 low、medium、high。

视频输入报价示例：

{
  "model": "seedance-2",
  "duration": 5,
  "resolution": "720p",
  "reference_videos": ["https://cdn.example.com/input.mp4"],
  "input_video_duration": 8,
  "generate_audio": true
}

该接口为只读操作：不会创建任务、冻结余额或写入用量。

计费生命周期

/v1/quote 只读预估，不冻结积分。
/v1/generations 按实际请求重新匹配售价并授权积分。
任务运行时，这部分积分体现在余额的 authorized_amount。
成功后按授权快照结算；失败或取消时释放未结算授权。

pricing_version 和 matched_rule_id 用于排查与对账，不需要客户端构造。perk_applied=true 表示已应用当前工作空间权益；estimated_credits 始终是该请求的总预估积分。

请求参数

示例

响应

计费生命周期

本页目录