创建视频

使用统一 JSON 结构提交请求并返回任务 ID；模型专属参数通过公共字段或 metadata 传递。

POST/v1/video/generations

根据文本提示和可选图片创建异步视频生成任务。接口返回 task_id，用于后续查询任务状态和结果。

不同模型支持的输入形式和厂商扩展参数可能不同。请选择当前 API Key 可见且支持视频生成的模型，并仅传递该模型支持的参数。

Authorization

bearerAuth

AuthorizationBearer <token>

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

In: header

Request Body

application/json

使用 JSON 提交模型、提示词和可选的视频生成参数。

TypeScript Definitions

Use the request body type in TypeScript.

model*string

要使用的视频模型 ID。请选择当前 API Key 可见且支持视频生成的模型。

Length1 <= length

prompt*string

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

Length1 <= length

duration?number

视频时长，单位为秒。可选范围取决于所选模型。

fps?integer

输出视频的帧率。是否支持及可选范围取决于所选模型。

height?integer

输出视频高度。可以与 width 配合使用；是否支持取决于所选模型。

width?integer

输出视频宽度。可以与 height 配合使用；是否支持取决于所选模型。

size?string

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

image?string

图生视频使用的图片输入，可以是图片 URL 或 Base64 数据；具体输入形式取决于所选模型。

metadata?

厂商或模型专用的扩展参数，例如 negative_prompt、style、quality_level、首尾帧和回调地址。这些字段不代表所有视频模型均支持。

n?integer

期望生成的视频数量。是否支持及可选范围取决于所选模型。

response_format?string

期望的响应格式。可选值取决于所选模型和渠道。

seed?integer

用于控制生成随机性的种子。是否支持取决于所选模型。

user?string

调用方提供的终端用户标识符。

Response Body

`application/json`

curl -X POST "https://example.com/v1/video/generations" \  -H "Content-Type: application/json" \  -d '{    "model": "MODEL_ID",    "prompt": "一个穿着宇航服的宇航员在月球上行走，高品质，电影级",    "size": "1920x1080",    "image": "https://example.com/input.jpg",    "duration": 5,    "metadata": {      "seed": 20231234,      "negative_prompt": "模糊",      "image_tail": "https://example.com/end-frame.png"    }  }'

{
  "id": "video_123",
  "object": "video",
  "model": "MODEL_ID",
  "created_at": 1640995200,
  "task_id": "abcd1234efgh",
  "status": "processing"
}

Authorization

Request Body

Response Body

201application/json

400application/json

401application/json

403application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`