生成视频

POST 
/v1/videos

按描述生成一段视频——可以从首帧（以及尾帧）出发，或在 pro 质量下参照参考图片、视频和音频。响应为 202，带上排队中的生成；用 GET /v1/videos/{video_id} 轮询，直到它变为 completed（此时它的 files 里就是结果）或 failed。发起生成需要项目的计费账户有可用余额，且每个终端用户同时最多有 3 个未完成的生成。

请求

响应

202

成功响应

401

鉴权失败：凭证缺失、格式错误、已过期或已作废。

• invalid_token — 访问令牌无效。
• project_disabled — 此项目未启用。
• token_expired — 访问令牌已过期。
• user_disabled — 此用户未启用。

404

请求的资源不存在，或对调用方不可见。

• file_not_found — 找不到请求的文件。
• file_expired — 请求的文件已过期。

409

请求与资源的当前状态冲突。

• idempotency_conflict — 这个 Idempotency-Key 属于另一个请求。
• idempotency_in_progress — 带这个 Idempotency-Key 的第一次请求仍在处理中。请稍后用同一个键重试。

413

请求体超过了允许的上限。

• payload_too_large — 请求体太大。

422

请求中的某个值未通过校验；details 数组会列出每个出错的字段。

• validation_failed — 请求内容未通过校验。

429

要么是请求太多（Retry-After 响应头会说明何时重试），要么是计费账户的积分已用完（不带 Retry-After——加上积分才能继续）；用 code 字段区分这两种情况。

• insufficient_credits — 计费账户的积分不足。
• insufficient_available_credits — 计费账户余额中可用于这个请求的部分太少：其余部分被该账户仍在进行中的生成占用。请等它们完成，或加上积分。
• rate_limited — 请求太频繁，请放慢速度。

500

服务端发生了意外错误。

• internal — 发生了意外错误。