提交视频任务 - GravitexAI Documentation

简介

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

认证

Authorization

string

必填

Bearer Token，如 Bearer sk-xxxxxxxxxx

请求参数

model

string

必填

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

sora-2 - 支持文生视频、图生视频、视频生视频（Remix 模式）。也可走 POST /v1/videos，详见 Sora 2

谷歌 Veo 系列：

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

阿里万相系列：

wan2.7-t2v-2026-04-25 - 文生视频（多镜头、自定义音频），详见万相 2.7
wan2.7-i2v-2026-04-25 - 图生视频（首帧、首尾帧、视频续写），详见万相 2.7
wan2.7-r2v - 参考生视频（多模态参考、音色参考），详见万相 2.7
wan2.5-t2v-preview - 文生视频
wan2.5-i2v-preview - 图生视频（首帧模式）

Seedance 2.0 系列：

seedance-2-0 - 文生视频、图生视频、多模态参考、素材库（asset://），详见 Seedance 2.0
seedance-2-0-fast - 快速版（不支持 1080p），详见 Seedance 2.0

豆包 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://api.gravitex.ai/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://api.gravitex.ai/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://api.gravitex.ai/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://api.gravitex.ai/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://api.gravitex.ai/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://api.gravitex.ai/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://api.gravitex.ai/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://api.gravitex.ai/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://api.gravitex.ai/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://api.gravitex.ai/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://api.gravitex.ai/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://api.gravitex.ai/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://api.gravitex.ai/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://api.gravitex.ai/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://api.gravitex.ai/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://api.gravitex.ai/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://api.gravitex.ai/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://api.gravitex.ai/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://api.gravitex.ai/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://api.gravitex.ai/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）

Documentation Index

​简介

​认证

​请求参数

​模型专用参数

​使用示例

​响应示例

​相关接口

查询视频任务

下载视频

简介

认证

请求参数

模型专用参数

使用示例

响应示例

相关接口