生成视频

请求体

只接受这些字段：其他字段会被拒绝或忽略。

• modelstring必填

  GET /videos/models 中的视频模型 id，例如 alibaba/wan-3.0。

• promptstring

  视频中发生什么：场景、动作和镜头。最多 2,000 个字符。除非视频从图片开始或延长一个视频，否则必填。

• durationinteger必填

  秒数，必须是模型 supported_durations 中的一个值。

• resolutionstring必填

  例如 720p，必须是模型 supported_resolutions 中的一个值。

• aspect_ratiostring必填

  例如 "16:9" 或 "9:16"，必须是模型 supported_aspect_ratios 中的一个值。

• generate_audioboolean

  声音，适用于 generate_audio: true 的模型。不填时关闭。

• seedinteger

  同样的种子和设置会生成相似的视频，适用于 seed: true 的模型。

• frame_imagesobject[]

  视频开始或结束时的图片，每张为 { "type": "image_url", "image_url": { "url": "https://..." }, "frame_type": "first_frame" }（或 last_frame），以模型的 supported_frame_images 为准。链接须为公开的 https 链接。

• input_referencesobject[]

  要在视频中保留的人物、物品或风格的图片，每张为 { "type": "image_url", "image_url": { "url": "https://..." } }，最多为模型的 max_input_references 张，须为公开的 https 链接。不能与 frame_images 同时使用。

• previous_job_idstring

  要继续延长的、此 Agent 已完成的视频，适用于 extends: true 的模型。

请求头

• Idempotency-Keystring

  8 到 64 个字母、数字、- 或 _。用同一个键再次调用会返回同一个视频，不会生成新的视频。

返回

• idstring

  视频的 id：vid_ 加 20 个字母和数字。

• status"pending" | "in_progress" | "completed" | "failed" | "expired"

  生成期间为 pending 或 in_progress，之后为 completed 或 failed；不再保留时为 expired。

• polling_urlstring

  读取任务的地址：每隔约 10 秒用你的密钥 GET 一次。

• unsigned_urlsstring[]

  完成后：用你的密钥 GET 文件的地址。它返回一个有效期一小时的链接。

• estimated_costnumber

  这个视频的最高花费，单位为美元。在视频结束前从你的余额中预留。

• usageobject | null

  完成后：cost，实际扣费。生成失败的视频不扣费。

• errorobject | null

  失败原因，以 code 表示，例如 content_refused。

• expires_atstring | null

  文件的删除时间：生成 30 天后。