提交视频任务

简介

提交视频生成任务接口用于创建新的视频生成任务。提交成功后会返回任务ID，您可以使用该任务ID查询任务状态。 重要提示：视频生成是异步任务，需要先提交任务获取任务ID，然后轮询查询任务状态直到成功。

认证

Authorization

string

必填

Bearer Token，如 Bearer sk-xxxxxxxxxx

请求参数

model

string

必填

模型标识，支持的模型及功能如下：Sora 2 系列：

sora-2 - 支持文生视频、图生视频、视频生视频（Remix 模式）

谷歌 Veo 系列：

veo-3.0-fast-generate-001 - 文生视频（首帧模式）
veo-3.1-fast-generate-preview - 文生视频（首帧模式、首尾帧模式）

阿里万相系列：

wan2.5-t2v-preview - 文生视频
wan2.5-i2v-preview - 图生视频（首帧模式）

豆包 Seedance 系列：

doubao-seedance-1-0-lite-t2v-250428 - 文生视频
doubao-seedance-1-0-lite-i2v-250428 - 图生视频（首帧模式、首尾帧模式、参考图模式）
doubao-seedance-1-0-pro-250528 - 文生视频（首帧模式）
doubao-seedance-1-5-pro-251215 - 文生视频、图生视频（首帧模式、首尾帧模式），支持音频生成
doubao-seedance-1-5-pro-251215-noAudio - 文生视频、图生视频（首帧模式、首尾帧模式），不生成音频

prompt

string

视频生成提示词，描述画面动作和场景。注意：豆包 Seedance 系列模型不需要此字段，提示词直接写在 metadata.content 数组的 text 字段中

image

string

图生视频时的参考图片（支持 Base64 或 URL 格式）

duration

integer

默认值:"5"

视频时长（秒），不同模型支持不同时长

resolution

string

默认值:"720p"

视频分辨率：480p、720p、1080p、4k

aspect_ratio

string

默认值:"16:9"

宽高比：16:9、9:16、1:1、4:3、3:4、21:9、adaptive（自适应，仅部分模型支持）

模型专用参数

不同模型支持不同的专用参数，以下按模型系列分类说明：

Sora 2
Veo
阿里万相
豆包 Seedance

seconds

string|integer

默认值:"4"

视频时长（秒），支持：4、8、12

size

string

默认值:"720x1280"

视频分辨率，支持：720x1280（竖屏）、1280x720（横屏）

input_reference

string

参考图片（支持 URL 或 Base64 格式），用于图生视频

remix_from_video_id

string

Remix 模式：基于已有视频ID重新生成（必须以 video_ 开头）

durationSeconds

integer

默认值:"4"

视频时长（秒），支持：4、6、8

aspectRatio

string

默认值:"16:9"

宽高比，仅支持：16:9、9:16

resolution

string

默认值:"1080p"

分辨率，支持：720p、1080p

fps

integer

默认值:"24"

帧率，默认 24

image

string

首帧参考图（支持 URL 或 Base64 格式）

lastFrame

string

尾帧参考图（支持 URL 或 Base64 格式），仅 veo-3.1 系列支持

generateAudio

boolean

默认值:"false"

是否生成同步音频。快速版模型会忽略该参数并始终包含音频

personGeneration

string

默认值:"allow_all"

人像生成策略：allow_all（所有年龄）、allow_adult（成年人）、dont_allow（禁止人像）

addWatermark

boolean

默认值:"false"

是否添加水印

seed

integer

随机种子，用于复现结果

sampleCount

integer

默认值:"1"

每次生成的视频数量，范围：1-4

duration

integer

默认值:"5"

视频时长（秒），支持：5、10

resolution

string

默认值:"720p"

视频分辨率，支持：480p、720p、1080p

size

string

视频尺寸（仅 t2v 模式），格式：宽度*高度，如 1280*720

smart_rewrite

boolean

默认值:"false"

是否启用智能提示词扩写

generate_audio

boolean

默认值:"false"

是否生成与画面同步的音频

audio_url

string

自定义音频文件URL（HTTPS格式）

seed

integer

随机种子，范围：0-2147483647

metadata.content

array

必填

内容数组，必须放在 metadata 对象中。必须包含文本和可选的图片。参数通过文本提示词中的特殊标记控制：

--rs 或 --resolution：分辨率（480p、720p、1080p）
--ratio：宽高比（16:9、9:16、1:1、4:3、3:4、adaptive，注意 doubao-seedance-1-0-lite-t2v-250428 不支持 adaptive）
--dur 或 --duration：时长（秒，如 5、10）
--frames：帧数（仅 1.5 pro 系列支持）。与 --dur 二选一即可，frames 的优先级高于 duration。如果您希望生成小数秒的视频，建议指定 frames。取值范围：支持 [29, 289] 区间内所有满足 25 + 4n 格式的整数值，其中 n 为正整数
--fps 或 --framespersecond：帧率（如 24、30）
--seed：随机种子，取值范围：[-1, 2^32-1]之间的整数
--wm 或 --watermark：水印开关（true、false）
--cf 或 --camerafixed：固定摄像头（true、false，仅 lite 模型支持）

模型特性说明：

1.0 lite/pro 系列：doubao-seedance-1-0-lite-t2v-250428、doubao-seedance-1-0-lite-i2v-250428、doubao-seedance-1-0-pro-250528
- 支持基础视频生成功能
- lite-i2v 支持首尾帧模式和参考图模式
- pro 模型支持高分辨率（720p/1080p）
1.5 pro 系列：doubao-seedance-1-5-pro-251215、doubao-seedance-1-5-pro-251215-noAudio
- 1.5-pro：支持文生视频和图生视频（首帧模式、首尾帧模式），自动生成匹配的音频
- 1.5-pro-noAudio：与 1.5-pro 功能相同，但不生成音频，视频渲染更快
- 分辨率支持：仅支持 480p 和 720p（不支持 1080p）
- 时长支持：4-12 秒之间的任意整数（如 4、5、6、7、8、9、10、11、12）
- 图生视频模式：支持首帧模式和首尾帧模式（不支持参考图模式）

metadata.content 数组格式：

{
  "metadata": {
    "content": [
      {
        "type": "text",
        "text": "提示词内容 --ratio 16:9 --dur 5 --rs 720p --wm false"
      },
      {
        "type": "image_url",
        "image_url": {
          "url": "data:image/png;base64,..."
        },
        "role": "first_frame"  // 可选：first_frame、last_frame、reference_image
      }
    ],
    "return_last_frame": true,  // 是否返回最后一帧（1.5 Pro 系列）
    "callback_url": "https://your-domain.com/callback"  // 可选的回调 URL
  }
}

使用示例

Sora 2
Veo
阿里万相
豆包 Seedance

1. 文生视频（基础示例）

curl -X POST "https://llm.ai-nebula.com/v1/video/generations" \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora-2",
    "prompt": "一只可爱的小猫在花园里玩耍，阳光明媚，画面温馨",
    "seconds": "4",
    "size": "720x1280"
  }'

2. 文生视频（横屏，8秒）

curl -X POST "https://llm.ai-nebula.com/v1/video/generations" \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora-2",
    "prompt": "一只可爱的小猫在花园里玩耍，阳光明媚，画面温馨",
    "seconds": "8",
    "size": "1280x720"
  }'

3. 图生视频（首帧模式）

curl -X POST "https://llm.ai-nebula.com/v1/video/generations" \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora-2",
    "prompt": "一只可爱的小猫在花园里玩耍，阳光明媚，画面温馨",
    "seconds": "4",
    "size": "720x1280",
    "input_reference": "data:image/png;base64,iVBORw0KGgoAAxxxx..."
  }'

4. Remix 模式（视频生视频）

curl -X POST "https://llm.ai-nebula.com/v1/video/generations" \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora-2",
    "prompt": "将视频改成夜晚场景，添加星空",
    "seconds": "4",
    "size": "720x1280",
    "remix_from_video_id": "video_69095b4ce0048190893a01510c0c98b0"
  }'

1. 文生视频（基础示例）

curl -X POST "https://llm.ai-nebula.com/v1/video/generations" \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "veo-3.1-fast-generate-preview",
    "prompt": "科幻城市鸟瞰图，黎明时分，阳光穿透云层",
    "durationSeconds": 8,
    "aspectRatio": "16:9",
    "resolution": "1080p",
    "fps": 24
  }'

2. 图生视频（首帧模式）

curl -X POST "https://llm.ai-nebula.com/v1/video/generations" \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "veo-3.1-fast-generate-preview",
    "prompt": "基于这张图片生成视频，画面逐渐展开",
    "durationSeconds": 8,
    "aspectRatio": "16:9",
    "resolution": "1080p",
    "fps": 24,
    "image": "data:image/png;base64,iVBORw0KGgoAAxxxx..."
  }'

3. 图生视频（首尾帧模式，仅 veo-3.1 支持）

curl -X POST "https://llm.ai-nebula.com/v1/video/generations" \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "veo-3.1-fast-generate-preview",
    "prompt": "从第一张图过渡到第二张图",
    "durationSeconds": 8,
    "aspectRatio": "16:9",
    "resolution": "1080p",
    "fps": 24,
    "image": "data:image/png;base64,iVBORw0KGgoAAxxxx...",
    "lastFrame": "data:image/png;base64,iVBORw0KGgoAAyyyy..."
  }'

1. 文生视频（基础示例）

curl -X POST "https://llm.ai-nebula.com/v1/video/generations" \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan2.5-t2v-preview",
    "prompt": "一只小猫慢慢睁开眼睛，耳朵轻轻抖动，镜头慢慢推进",
    "duration": 5,
    "size": "1280*720",
    "smart_rewrite": true,
    "generate_audio": true
  }'

2. 文生视频（10秒，1080p，带随机种子）

curl -X POST "https://llm.ai-nebula.com/v1/video/generations" \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan2.5-t2v-preview",
    "prompt": "一只小猫慢慢睁开眼睛，耳朵轻轻抖动，镜头慢慢推进",
    "duration": 10,
    "size": "1920*1080",
    "smart_rewrite": false,
    "generate_audio": false,
    "seed": 123456
  }'

3. 图生视频（首帧模式）

curl -X POST "https://llm.ai-nebula.com/v1/video/generations" \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan2.5-i2v-preview",
    "prompt": "小猫慢慢睁开眼睛，耳朵轻轻抖动，镜头慢慢推进",
    "duration": 5,
    "resolution": "720p",
    "smart_rewrite": true,
    "generate_audio": true,
    "image": "data:image/png;base64,iVBORw0KGgoAAxxxx..."
  }'

4. 图生视频（带自定义音频）

curl -X POST "https://llm.ai-nebula.com/v1/video/generations" \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan2.5-i2v-preview",
    "prompt": "小猫慢慢睁开眼睛，耳朵轻轻抖动，镜头慢慢推进",
    "duration": 10,
    "resolution": "1080p",
    "smart_rewrite": false,
    "generate_audio": false,
    "audio_url": "https://example.com/audio.mp3",
    "image": "data:image/png;base64,iVBORw0KGgoAAxxxx...",
    "seed": 789012
  }'

1. 文生视频（T2V，基础示例）

curl -X POST "https://llm.ai-nebula.com/v1/video/generations" \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-1-0-lite-t2v-250428",
    "metadata": {
      "content": [
        {
          "type": "text",
          "text": "一只小猫在花园里玩耍，阳光明媚 --ratio 16:9 --dur 5 --rs 720p --wm false"
        }
      ]
    }
  }'

2. 文生视频（T2V，完整参数）

curl -X POST "https://llm.ai-nebula.com/v1/video/generations" \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-1-0-lite-t2v-250428",
    "metadata": {
      "content": [
        {
          "type": "text",
          "text": "一只小猫在花园里玩耍，阳光明媚 --ratio 9:16 --dur 10 --rs 1080p --fps 30 --wm true --seed 12345"
        }
      ]
    }
  }'

3. 图生视频（首帧模式）

curl -X POST "https://llm.ai-nebula.com/v1/video/generations" \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-1-0-lite-i2v-250428",
    "metadata": {
      "content": [
        {
          "type": "text",
          "text": "女孩睁开眼睛，温柔地看着镜头 --ratio adaptive --dur 5 --rs 720p --wm false"
        },
        {
          "type": "image_url",
          "image_url": {
            "url": "data:image/png;base64,iVBORw0KGgoAAxxxx..."
          }
        }
      ]
    }
  }'

4. 图生视频（首尾帧模式， lite-i2v 和1.5 pro支持）

curl -X POST "https://llm.ai-nebula.com/v1/video/generations" \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-1-0-lite-i2v-250428",
    "metadata": {
      "content": [
        {
          "type": "text",
          "text": "一只蓝绿色的精卫鸟变成人形 --rs 720p --dur 5 --fps 24 --cf false --wm false --seed 67890"
        },
        {
          "type": "image_url",
          "image_url": {
            "url": "data:image/png;base64,iVBORw0KGgoAAxxxx..."
          },
          "role": "first_frame"
        },
        {
          "type": "image_url",
          "image_url": {
            "url": "data:image/png;base64,iVBORw0KGgoAAyyyy..."
          },
          "role": "last_frame"
        }
      ]
    }
  }'

5. 图生视频（参考图模式，仅 lite-i2v 支持）

curl -X POST "https://llm.ai-nebula.com/v1/video/generations" \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-1-0-lite-i2v-250428",
    "metadata": {
      "content": [
        {
          "type": "text",
          "text": "[图1] 戴眼镜穿蓝色T恤的男孩和 [图2] 柯基狗，坐在 [图3] 草坪上，3D卡通风格 --rs 720p --dur 5 --ratio 16:9 --wm false"
        },
        {
          "type": "image_url",
          "image_url": {
            "url": "https://example.com/ref1.png"
          },
          "role": "reference_image"
        },
        {
          "type": "image_url",
          "image_url": {
            "url": "https://example.com/ref2.png"
          },
          "role": "reference_image"
        },
        {
          "type": "image_url",
          "image_url": {
            "url": "https://example.com/ref3.png"
          },
          "role": "reference_image"
        }
      ]
    }
  }'

6. Pro 模型（首帧模式）

curl -X POST "https://llm.ai-nebula.com/v1/video/generations" \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-1-0-pro-250528",
    "metadata": {
      "content": [
        {
          "type": "text",
          "text": "女孩睁开眼睛，温柔地看着镜头 --ratio 16:9 --dur 5 --rs 1080p --wm false"
        },
        {
          "type": "image_url",
          "image_url": {
            "url": "data:image/png;base64,iVBORw0KGgoAAxxxx..."
          }
        }
      ]
    }
  }'

7. Seedance 1.5 Pro 文生视频（带音频）

curl -X POST "https://llm.ai-nebula.com/v1/video/generations" \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-1-5-pro-251215",
    "metadata": {
      "content": [
        {
          "type": "text",
          "text": "一只可爱的小猫在花园里追逐蝴蝶，春天的阳光洒在花朵上 --ratio 16:9 --dur 6 --rs 720p --wm false"
        }
      ]
    }
  }'

8. Seedance 1.5 Pro 图生视频（首帧模式，不带音频）

curl -X POST "https://llm.ai-nebula.com/v1/video/generations" \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-1-5-pro-251215-noAudio",
    "metadata": {
      "content": [
        {
          "type": "text",
          "text": "画面逐渐动起来，人物微笑看向镜头 --ratio 16:9 --dur 5 --rs 720p --wm false"
        },
        {
          "type": "image_url",
          "image_url": {
            "url": "data:image/png;base64,iVBORw0KGgoAAxxxx..."
          }
        }
      ]
    }
  }'

9. Seedance 1.5 Pro 图生视频（首尾帧模式，带音频）

curl -X POST "https://llm.ai-nebula.com/v1/video/generations" \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-1-5-pro-251215",
    "metadata": {
      "content": [
        {
          "type": "text",
          "text": "从静态画面过渡到动态场景 --ratio 16:9 --dur 8 --rs 720p --wm false"
        },
        {
          "type": "image_url",
          "image_url": {
            "url": "data:image/png;base64,iVBORw0KGgoAAxxxx..."
          },
          "role": "first_frame"
        },
        {
          "type": "image_url",
          "image_url": {
            "url": "data:image/png;base64,iVBORw0KGgoAAyyyy..."
          },
          "role": "last_frame"
        }
      ]
    }
  }'

重要提示（豆包 Seedance 系列）：

content 数组必须放在 metadata 对象中
所有参数通过提示词中的特殊标记传递（如 --ratio 16:9）
图片必须放在 content 数组中，使用 image_url 类型
首尾帧模式需要两张图片，分别标记 role: "first_frame" 和 role: "last_frame"
参考图模式需要在提示词中使用 [图1]、[图2] 等标记引用图片，图片标记 role: "reference_image"
doubao-seedance-1-0-lite-t2v-250428 不支持图片输入和 adaptive 宽高比
doubao-seedance-1-0-pro-250528 仅支持首帧模式
doubao-seedance-1-5-pro-251215 自动生成音频，适合需要配乐的场景
doubao-seedance-1-5-pro-251215-noAudio 不生成音频，渲染速度更快，适合需要后期配音的场景
1.5 pro 系列支持文生视频和图生视频（首帧模式、首尾帧模式），不支持参考图模式
1.5 pro 系列分辨率限制：仅支持 480p 和 720p（不支持 1080p）
1.5 pro 系列时长范围：支持 4-12 秒之间的任意整数秒数
首尾帧模式：需要提供两张图片，分别标记 role: "first_frame" 和 role: "last_frame"

响应示例

{
  "task_id": "video_69095b4ce0048190893a01510c0c98b0",
  "status": "submitted",
  "format": "mp4"
}

查询视频任务

查询视频生成任务的状态和结果

下载视频

下载已完成的视频文件（仅 Sora 2）

API 文档

文本系列

文本向量系列

图像系列

视频系列

实时语音

简介

认证

请求参数

模型专用参数

使用示例

响应示例

相关接口

查询视频任务

下载视频

API 文档

文本系列

文本向量系列

图像系列

视频系列

实时语音

Documentation Index

​简介

​认证

​请求参数

​模型专用参数

​使用示例

​响应示例

​相关接口

查询视频任务

下载视频

简介

认证

请求参数

模型专用参数

使用示例

响应示例

相关接口