提交视频任务

提交视频任务

curl --request POST \
  --url https://api.gravitex.ai/v1/video/generations \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "prompt": "<string>",
  "image": "<string>",
  "duration": 123,
  "resolution": "<string>",
  "aspect_ratio": "<string>"
}
'

import requests

url = "https://api.gravitex.ai/v1/video/generations"

payload = {
    "model": "<string>",
    "prompt": "<string>",
    "image": "<string>",
    "duration": 123,
    "resolution": "<string>",
    "aspect_ratio": "<string>"
}
headers = {
    "Authorization": "<authorization>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: '<authorization>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    model: '<string>',
    prompt: '<string>',
    image: '<string>',
    duration: 123,
    resolution: '<string>',
    aspect_ratio: '<string>'
  })
};

fetch('https://api.gravitex.ai/v1/video/generations', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.gravitex.ai/v1/video/generations",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'model' => '<string>',
    'prompt' => '<string>',
    'image' => '<string>',
    'duration' => 123,
    'resolution' => '<string>',
    'aspect_ratio' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <authorization>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.gravitex.ai/v1/video/generations"

	payload := strings.NewReader("{\n  \"model\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"image\": \"<string>\",\n  \"duration\": 123,\n  \"resolution\": \"<string>\",\n  \"aspect_ratio\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "<authorization>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.gravitex.ai/v1/video/generations")
  .header("Authorization", "<authorization>")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"image\": \"<string>\",\n  \"duration\": 123,\n  \"resolution\": \"<string>\",\n  \"aspect_ratio\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.gravitex.ai/v1/video/generations")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<authorization>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"model\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"image\": \"<string>\",\n  \"duration\": 123,\n  \"resolution\": \"<string>\",\n  \"aspect_ratio\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

POST

video

generations

提交视频任务

curl --request POST \
  --url https://api.gravitex.ai/v1/video/generations \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "prompt": "<string>",
  "image": "<string>",
  "duration": 123,
  "resolution": "<string>",
  "aspect_ratio": "<string>"
}
'

import requests

url = "https://api.gravitex.ai/v1/video/generations"

payload = {
    "model": "<string>",
    "prompt": "<string>",
    "image": "<string>",
    "duration": 123,
    "resolution": "<string>",
    "aspect_ratio": "<string>"
}
headers = {
    "Authorization": "<authorization>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: '<authorization>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    model: '<string>',
    prompt: '<string>',
    image: '<string>',
    duration: 123,
    resolution: '<string>',
    aspect_ratio: '<string>'
  })
};

fetch('https://api.gravitex.ai/v1/video/generations', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.gravitex.ai/v1/video/generations",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'model' => '<string>',
    'prompt' => '<string>',
    'image' => '<string>',
    'duration' => 123,
    'resolution' => '<string>',
    'aspect_ratio' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <authorization>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.gravitex.ai/v1/video/generations"

	payload := strings.NewReader("{\n  \"model\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"image\": \"<string>\",\n  \"duration\": 123,\n  \"resolution\": \"<string>\",\n  \"aspect_ratio\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "<authorization>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.gravitex.ai/v1/video/generations")
  .header("Authorization", "<authorization>")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"image\": \"<string>\",\n  \"duration\": 123,\n  \"resolution\": \"<string>\",\n  \"aspect_ratio\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.gravitex.ai/v1/video/generations")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<authorization>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"model\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"image\": \"<string>\",\n  \"duration\": 123,\n  \"resolution\": \"<string>\",\n  \"aspect_ratio\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

简介

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

认证

string

必填

Bearer Token，如 Bearer sk-xxxxxxxxxx

请求参数

string

必填

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

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

谷歌 Veo 系列：

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

Gemini Omni 系列：

gemini-omni-flash-preview - 文生视频、单图图生视频（含音频）；亦可走 POST /v1beta/interactions，详见 Gemini Omni Flash 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 - 文生视频，详见万相 2.5
wan2.5-i2v-preview - 图生视频（首帧模式），详见万相 2.5

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 - 文生视频、图生视频（首帧模式、首尾帧模式），不生成音频

string

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

string

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

integer

默认值:"5"

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

string

默认值:"720p"

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

string

默认值:"16:9"

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

模型专用参数

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

Sora 2
Veo
阿里万相
豆包 Seedance

string|integer

默认值:"4"

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

string

默认值:"720x1280"

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

string

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

string

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

integer

默认值:"4"

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

string

默认值:"16:9"

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

string

默认值:"1080p"

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

integer

默认值:"24"

帧率，默认 24

string

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

string

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

boolean

默认值:"false"

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

string

默认值:"allow_all"

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

boolean

默认值:"false"

是否添加水印

integer

随机种子，用于复现结果

integer

默认值:"1"

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

integer

默认值:"5"

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

string

默认值:"720p"

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

string

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

boolean

默认值:"false"

是否启用智能提示词扩写

boolean

默认值:"false"

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

string

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

integer

随机种子，范围：0-2147483647

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）

视频生成查询视频任务

API 文档

对话与文本

安全与音频

图像系列

视频系列

文本补全和向量嵌入

接口模块

简介

认证

请求参数

模型专用参数

使用示例

响应示例

相关接口

查询视频任务

下载视频

​简介

​认证

​请求参数

​模型专用参数

​使用示例

​响应示例

​相关接口

查询视频任务

下载视频

简介

认证

请求参数

模型专用参数

使用示例

响应示例

相关接口