视频生成报价

从源码生成 POST /video-generations/quote 的鉴权、字段、响应、错误与安全调用参考。

公开测试API v1 · 1.3.0最后核实 2026-08-30

本页目录

操作

POST /video-generations/quote

operationId: quote_video_generation_v1_video_generations_quote_post

为计划操作估算积分，不启动生产也不扣费。此报价不锁价、不构成支出批准；创建时重新计算，应先确认报价，并保持影响价格的选项与后续请求一致。

使用可信环境中的 Bearer API Key。所需权限：animations:write

此操作不启动付费生成，其他状态变化见上文说明。

无路径、查询或操作专属请求头参数。

请求体必填：true

字段	类型	必填	默认值	约束	含义
`has_last_frame`	`boolean`	否	`false`	—	计划请求是否包含尾帧。
`reference_image_count`	`integer`	否	`0`	`minimum`: `0`; `maximum`: `8`	额外参考图数量，不含首帧。
`video`	VideoOptions	否	`{"duration_seconds":null,"input_canvas":null,"model":null,"ratio":null,"resolution":null,"seed":null,"style_preset":null,"transparency":{"key_color":null,"key_selection":"auto","mode":"standard"},"watermark":null}`	—	拟报价的生成选项，应与后续创建一致。

json

{
  "has_last_frame": false,
  "reference_image_count": 0,
  "video": {}
}

HTTP	正文	含义
`200`	QuoteResponse	成功的公开响应，示例数值仅用于说明。
`400`	APIErrorEnvelope	输入错误，修正请求后再尝试。
`401`	APIErrorEnvelope	API Key 缺失、到期或被撤销。
`402`	APIErrorEnvelope	积分不足，不自动购买。
`403`	APIErrorEnvelope	账户资格、账户状态或 Key 权限不允许此操作。
`404`	APIErrorEnvelope	资源不可用、不属于当前用户，或签名无效/过期。
`413`	APIErrorEnvelope	请求或解码后的图片超过配置限制。
`415`	APIErrorEnvelope	使用支持的图片媒体类型。
`422`	APIErrorEnvelope	图片解码后尺寸超过限制。
`429`	APIErrorEnvelope	触发账户级速率或队列限制，遵循 Retry-After 等待。
`500`	APIErrorEnvelope	内部错误，保留任务 ID 和幂等键，仅标记可重试时重试。
`503`	APIErrorEnvelope	服务或供应商不可用，仅 error.retryable 为 true 时重试。

HTTP	响应头	类型	含义
`429`	`Retry-After`	`integer`	建议等待秒数，遵循服务值并设置总体截止时间。
`503`	`Retry-After`	`integer`	建议等待秒数，遵循服务值并设置总体截止时间。

json

{
  "breakdown": {},
  "credits": 1,
  "object": "quote"
}

允许文档使用分析

不收集搜索词、代码或自由文本。此开关只控制文档交互事件；站点通用分析仍遵循隐私政策。隐私政策