创建视频生成任务

提交视频生成任务,支持文生视频和图生视频。 返回任务 ID,可通过 GET 接口查询任务状态。

POST /v1/video/generations

服务根地址: https://getrouter.ai

协议: 视频任务接口

认证: Authorization: Bearer YOUR_API_KEY

请求体

请求体必填。 媒体类型: application/json

请求字段

字段类型必填说明
modelstring模型/风格 ID
promptstring文本描述提示词
imagestring图片输入(URL 或 Base64)
durationnumber视频时长(秒)
widthinteger视频宽度
heightinteger视频高度
fpsinteger视频帧率
seedinteger随机种子
ninteger生成视频数量
response_formatstring响应格式
userstring用户标识
metadataobject扩展参数(如 negative_prompt、style、quality_level 等)

请求示例

curl --request POST \
  --url https://getrouter.ai/v1/video/generations \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{}'

响应

状态码说明
200成功创建视频生成任务
400请求参数错误

成功响应字段

字段类型必填说明
task_idstring任务 ID
statusstring任务状态

响应示例

{
  "task_id": "TASK_ID",
  "status": "completed"
}

相关指南

需要完整调用流程和场景示例时,请阅读 视频 使用指南。


此页面由公开 Relay OpenAPI 自动生成。完整规范可在 API Explorer 中查看。