创建视频

根据文本提示和可选参考图片创建异步任务，并返回用于查询状态和下载结果的 Video ID。

POST/v1/videos

根据文本提示和可选参考图片创建异步视频生成任务。接口接受 OpenAI Videos 兼容的 Multipart 请求，并返回可用于查询任务状态的 Video ID。

不同视频模型支持的时长、尺寸、参考图片和扩展参数可能不同。请选择当前 API Key 可见且支持视频生成的模型 ID。

Authorization

bearerAuth

AuthorizationBearer <token>

在 Authorization Header 中使用 Bearer your-api-key。

In: header

Request Body

multipart/form-data

使用 Multipart 提交提示词、模型和可选参考图片。客户端应由请求库自动生成 Content-Type 的 boundary。

TypeScript Definitions

Use the request body type in TypeScript.

prompt*string

描述期望生成的视频内容。建议明确主体、动作、场景、镜头、风格和质量要求。

Length1 <= length

model?string

要使用的视频模型 ID。请选择当前 API Key 可见且支持视频生成的模型；不同模型支持的输入方式和扩展参数可能不同。

Length1 <= length

seconds?string

视频时长，单位为秒，默认值为 4；实际可选时长取决于所选模型。

Default"4"

size?string

输出视频尺寸，通常使用 宽度x高度 格式，默认值为 720x1280；实际可选尺寸取决于所选模型。

Default"720x1280"

input_reference?file

图生视频时上传的参考图片。部分兼容模型不接受直接上传文件，需要改用 metadata.img_url 传递图片 URL。

Formatbinary

metadata?string

厂商或模型专用扩展参数，必须作为 JSON 字符串提交。不要将其中的字段视为所有视频模型都支持的公共参数。

Wan 系列扩展键包括：img_url、first_frame_url、last_frame_url、watermark、prompt_extend、audio、seed 和 resolution。其中图片 URL 用于图生视频，首尾帧 URL 用于关键帧视频；audio 仅适用于支持音频生成的模型。

分辨率选项包括 480P（832x480、480x832、624x624）、720P（1280x720、720x1280、960x960、1088x832、832x1088）和 1080P（1920x1080、1080x1920、1440x1440、1632x1248、1248x1632）。实际支持范围以所选模型为准。

Response Body

`application/json`

curl -X POST "https://example.com/v1/videos" \  -F prompt="一个穿着宇航服的宇航员在月球上行走，高品质，电影级" \  -F model="MODEL_ID" \  -F seconds="4" \  -F size="720x1280"

{
  "id": "video_123",
  "object": "video",
  "model": "MODEL_ID",
  "created_at": 1640995200,
  "status": "processing",
  "progress": 0
}

Authorization

Request Body

Response Body

201application/json

400application/json

401application/json

403application/json

404application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`