跳转到主要内容
POST
/
prod-api
/
nebula
/
v4
/
api
/
image2VideoTradition
图生视频-传统模式-提交任务
curl --request POST \
  --url https://leapx-hub.com/prod-api/nebula/v4/api/image2VideoTradition \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "image2VideoTraditionalDTO.image_urls": {},
  "image2VideoTraditionalDTO.prompt": "<string>",
  "image2VideoTraditionalDTO.duration": "<string>",
  "image2VideoTraditionalDTO.resolution": "<string>",
  "image2VideoTraditionalDTO.req_key": "<string>",
  "image2VideoTraditionalDTO.return_url": true
}
'
{
  "code": 200,
  "msg": "操作成功",
  "data": {
    "id": "task-1234567890"
  }
}

​
简介

提交传统模式图生视频任务，用于根据输入图片生成视频。

​
认证

​
Authorization
string
必填
Bearer Token，如 Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9... 获取方法：依照左侧最上面认证模块的post接口获取，https://docs.leapx-hub.com/cn/leapx-lab-v4/endpoint/get-token

​
请求参数

​
image2VideoTraditionalDTO.image_urls
array[string]
必填
输入图片 URL 数组： 0：原始输入图片（三通道 RGB 图） 1：可选遮罩图（单通道灰度图；黑色区域为保留0，白色区域为消除255）
​
image2VideoTraditionalDTO.prompt
string
必填
提示词，用于描述目标视频效果
​
image2VideoTraditionalDTO.duration
string
必填
视频时长，支持多种格式： 30（秒）、30s、1m、1m30s（分钟+秒）
​
image2VideoTraditionalDTO.resolution
string
必填
视频分辨率（枚举）：480p、720p、1080p
​
image2VideoTraditionalDTO.req_key
string
请求标识，可用于业务侧关联与去重
​
image2VideoTraditionalDTO.return_url
boolean
是否直接返回生成结果的 URL（默认关闭）

​
示例代码

curl -X POST "https://leapx-hub.com/prod-api/nebula/v4/api/image2VideoTradition" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -d '{
    "image_urls": ["https://example.com/input.jpg"],
    "prompt": "镜头缓慢推进，人物微笑",
    "duration": "5",
    "resolution": "720p",
    "req_key": "req-001",
    "return_url": true
  }'

​
响应示例

{
  "code": 200,
  "msg": "操作成功",
  "data": {
    "id": "task-1234567890"
  }
}