创建视频生成任务 API（seedance-2.0)

POST https://api.quickrouter.ai/api/v3/contents/generations/tasks 在线调试 →

▼ Authorization

在 Header 添加参数 Authorization，其值为 Bearer 之后拼接 Token

示例： Authorization: Bearer ********************

官方文档：https://www.volcengine.com/docs/82379/1520757

请求参数

Body 参数 application/json 必填

model string

必需

模型名称，如 doubao-seedance-2-0-260128

content array [object]

必需

输入给模型的内容数组，支持文本、图片、视频、音频等多种类型。

type string

必需

输入内容类型：text 文本、image_url 图片、video_url 视频、audio_url 音频

text string

可选

文本提示词，描述期望生成的视频内容。支持中英文，建议不超过500字。

image_url object

可选

图片对象，包含 url 字段。

video_url object

可选

视频对象，包含 url 字段。

audio_url object

可选

音频对象，包含 url 字段。

role string

可选

资源用途：reference_image 参考图、reference_video 参考视频、reference_audio 参考音频、first_frame 首帧、last_frame 尾帧

generate_audio boolean

可选

是否生成同步音频。true 生成带音频视频，false 无声视频。

ratio string

可选

视频宽高比例：16:9、4:3、1:1、3:4、9:16、21:9

duration integer

可选

生成视频时长（秒），支持 2-12 秒。默认值 5。

watermark boolean

可选

是否包含水印。false 无水印，true 含水印。默认 false。

示例

{
    "model": "doubao-seedance-2-0-260128",
    "content": [
        {
            "type": "text",
            "text": "第一人称视角果茶宣传广告..."
        },
        {
            "type": "image_url",
            "image_url": {
                "url": "https://example.com/image1.jpg"
            },
            "role": "reference_image"
        },
        {
            "type": "video_url",
            "video_url": {
                "url": "https://example.com/video.mp4"
            },
            "role": "reference_video"
        },
        {
            "type": "audio_url",
            "audio_url": {
                "url": "https://example.com/audio.mp3"
            },
            "role": "reference_audio"
        }
    ],
    "generate_audio": true,
    "ratio": "21:9",
    "duration": 11,
    "watermark": false
}

请求示例代码

curl --location --request POST 'https://api.quickrouter.ai/api/v3/contents/generations/tasks' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "doubao-seedance-2-0-260128",
    "content": [
        {
            "type": "text",
            "text": "第一人称视角果茶宣传广告..."
        },
        {
            "type": "image_url",
            "image_url": {
                "url": "https://example.com/image1.jpg"
            },
            "role": "reference_image"
        },
        {
            "type": "video_url",
            "video_url": {
                "url": "https://example.com/video.mp4"
            },
            "role": "reference_video"
        },
        {
            "type": "audio_url",
            "audio_url": {
                "url": "https://example.com/audio.mp3"
            },
            "role": "reference_audio"
        }
    ],
    "generate_audio": true,
    "ratio": "21:9",
    "duration": 11,
    "watermark": false
}'

var myHeaders = new Headers();
myHeaders.append("Accept", "application/json");
myHeaders.append("Authorization", "Bearer YOUR_API_KEY");
myHeaders.append("Content-Type", "application/json");

var raw = JSON.stringify({
    "model": "doubao-seedance-2-0-260128",
    "content": [
        {
            "type": "text",
            "text": "第一人称视角果茶宣传广告..."
        },
        {
            "type": "image_url",
            "image_url": {
                "url": "https://example.com/image1.jpg"
            },
            "role": "reference_image"
        },
        {
            "type": "video_url",
            "video_url": {
                "url": "https://example.com/video.mp4"
            },
            "role": "reference_video"
        },
        {
            "type": "audio_url",
            "audio_url": {
                "url": "https://example.com/audio.mp3"
            },
            "role": "reference_audio"
        }
    ],
    "generate_audio": true,
    "ratio": "21:9",
    "duration": 11,
    "watermark": false
});

var requestOptions = {
   method: 'POST',
   headers: myHeaders,
   body: raw,
   redirect: 'follow'
};

fetch("https://api.quickrouter.ai/api/v3/contents/generations/tasks", requestOptions)
   .then(response => response.text())
   .then(result => console.log(result))
   .catch(error => console.log('error', error));

import java.io.*;
import java.net.*;
import java.util.*;

URL url = new URL("https://api.quickrouter.ai/api/v3/contents/generations/tasks");
HttpURLConnection conn = (HttpURLConnection) url.openConnection();
conn.setRequestMethod("POST");
conn.setRequestProperty("Accept", "application/json");
conn.setRequestProperty("Authorization", "Bearer YOUR_API_KEY");
conn.setRequestProperty("Content-Type", "application/json");
conn.setDoOutput(true);
String jsonInputString = "{
    \"model\": \"doubao-seedance-2-0-260128\",
    \"content\": [
        {
            \"type\": \"text\",
            \"text\": \"第一人称视角果茶宣传广告...\"
        },
        {
            \"type\": \"image_url\",
            \"image_url\": {
                \"url\": \"https://example.com/image1.jpg\"
            },
            \"role\": \"reference_image\"
        },
        {
            \"type\": \"video_url\",
            \"video_url\": {
                \"url\": \"https://example.com/video.mp4\"
            },
            \"role\": \"reference_video\"
        },
        {
            \"type\": \"audio_url\",
            \"audio_url\": {
                \"url\": \"https://example.com/audio.mp3\"
            },
            \"role\": \"reference_audio\"
        }
    ],
    \"generate_audio\": true,
    \"ratio\": \"21:9\",
    \"duration\": 11,
    \"watermark\": false
}";
try(OutputStream os = conn.getOutputStream()) {
    byte[] input = jsonInputString.getBytes("utf-8");
    os.write(input, 0, input.length);
}
int responseCode = conn.getResponseCode();
System.out.println("Response Code: " + responseCode);

import Foundation

let urlString = "https://api.quickrouter.ai/api/v3/contents/generations/tasks"
guard let url = URL(string: urlString) else { return }
var request = URLRequest(url: url)
request.httpMethod = "POST"
request.addValue("application/json", forHTTPHeaderField: "Accept")
request.addValue("Bearer YOUR_API_KEY", forHTTPHeaderField: "Authorization")
request.addValue("application/json", forHTTPHeaderField: "Content-Type")
let httpBody = "{
    \"model\": \"doubao-seedance-2-0-260128\",
    \"content\": [
        {
            \"type\": \"text\",
            \"text\": \"第一人称视角果茶宣传广告...\"
        },
        {
            \"type\": \"image_url\",
            \"image_url\": {
                \"url\": \"https://example.com/image1.jpg\"
            },
            \"role\": \"reference_image\"
        },
        {
            \"type\": \"video_url\",
            \"video_url\": {
                \"url\": \"https://example.com/video.mp4\"
            },
            \"role\": \"reference_video\"
        },
        {
            \"type\": \"audio_url\",
            \"audio_url\": {
                \"url\": \"https://example.com/audio.mp3\"
            },
            \"role\": \"reference_audio\"
        }
    ],
    \"generate_audio\": true,
    \"ratio\": \"21:9\",
    \"duration\": 11,
    \"watermark\": false
}"
request.httpBody = httpBody.data(using: .utf8)

let task = URLSession.shared.dataTask(with: request) { data, response, error in
    if let data = data {
        print(String(data: data, encoding: .utf8)!)
    }
}
task.resume()

package main

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

func main() {
    body := strings.NewReader(`{
    "model": "doubao-seedance-2-0-260128",
    "content": [
        {
            "type": "text",
            "text": "第一人称视角果茶宣传广告..."
        },
        {
            "type": "image_url",
            "image_url": {
                "url": "https://example.com/image1.jpg"
            },
            "role": "reference_image"
        },
        {
            "type": "video_url",
            "video_url": {
                "url": "https://example.com/video.mp4"
            },
            "role": "reference_video"
        },
        {
            "type": "audio_url",
            "audio_url": {
                "url": "https://example.com/audio.mp3"
            },
            "role": "reference_audio"
        }
    ],
    "generate_audio": true,
    "ratio": "21:9",
    "duration": 11,
    "watermark": false
}`)
    req, _ := http.NewRequest("POST", "https://api.quickrouter.ai/api/v3/contents/generations/tasks", body)
    req.Header.Set("Accept", "application/json")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
    req.Header.Set("Content-Type", "application/json")
    client := &http.Client{}
    resp, _ := client.Do(req)
    defer resp.Body.Close()
    bodyBytes, _ := io.ReadAll(resp.Body)
    fmt.Println(string(bodyBytes))
}

<?php

$curl = curl_init();
curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://api.quickrouter.ai/api/v3/contents/generations/tasks',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS => '{
    "model": "doubao-seedance-2-0-260128",
    "content": [
        {
            "type": "text",
            "text": "第一人称视角果茶宣传广告..."
        },
        {
            "type": "image_url",
            "image_url": {
                "url": "https://example.com/image1.jpg"
            },
            "role": "reference_image"
        },
        {
            "type": "video_url",
            "video_url": {
                "url": "https://example.com/video.mp4"
            },
            "role": "reference_video"
        },
        {
            "type": "audio_url",
            "audio_url": {
                "url": "https://example.com/audio.mp3"
            },
            "role": "reference_audio"
        }
    ],
    "generate_audio": true,
    "ratio": "21:9",
    "duration": 11,
    "watermark": false
}',
  CURLOPT_HTTPHEADER => array(
    "Accept: application/json",
    "Authorization: Bearer YOUR_API_KEY",
    "Content-Type: application/json",
  ),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;

import http.client
import json

conn = http.client.HTTPSConnection("api.quickrouter.ai")
payload = json.dumps({
    "model": "doubao-seedance-2-0-260128",
    "content": [
        {
            "type": "text",
            "text": "第一人称视角果茶宣传广告..."
        },
        {
            "type": "image_url",
            "image_url": {
                "url": "https://example.com/image1.jpg"
            },
            "role": "reference_image"
        },
        {
            "type": "video_url",
            "video_url": {
                "url": "https://example.com/video.mp4"
            },
            "role": "reference_video"
        },
        {
            "type": "audio_url",
            "audio_url": {
                "url": "https://example.com/audio.mp3"
            },
            "role": "reference_audio"
        }
    ],
    "generate_audio": true,
    "ratio": "21:9",
    "duration": 11,
    "watermark": false
})
headers = {
   'Accept': 'application/json',
   'Authorization': 'Bearer YOUR_API_KEY',
   'Content-Type': 'application/json',
}
conn.request("POST", "/api/v3/contents/generations/tasks", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))

POST https://api.quickrouter.ai/api/v3/contents/generations/tasks HTTP/1.1
Accept: application/json
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{
    "model": "doubao-seedance-2-0-260128",
    "content": [
        {
            "type": "text",
            "text": "第一人称视角果茶宣传广告..."
        },
        {
            "type": "image_url",
            "image_url": {
                "url": "https://example.com/image1.jpg"
            },
            "role": "reference_image"
        },
        {
            "type": "video_url",
            "video_url": {
                "url": "https://example.com/video.mp4"
            },
            "role": "reference_video"
        },
        {
            "type": "audio_url",
            "audio_url": {
                "url": "https://example.com/audio.mp3"
            },
            "role": "reference_audio"
        }
    ],
    "generate_audio": true,
    "ratio": "21:9",
    "duration": 11,
    "watermark": false
}

CURL *hnd = curl_easy_init();
curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "POST");
curl_easy_setopt(hnd, CURLOPT_URL, "https://api.quickrouter.ai/api/v3/contents/generations/tasks");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Accept: application/json");
headers = curl_slist_append(headers, "Authorization: Bearer YOUR_API_KEY");
headers = curl_slist_append(headers, "Content-Type: application/json");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);
curl_easy_setopt(hnd, CURLOPT_POSTFIELDS, "{
    \"model\": \"doubao-seedance-2-0-260128\",
    \"content\": [
        {
            \"type\": \"text\",
            \"text\": \"第一人称视角果茶宣传广告...\"
        },
        {
            \"type\": \"image_url\",
            \"image_url\": {
                \"url\": \"https://example.com/image1.jpg\"
            },
            \"role\": \"reference_image\"
        },
        {
            \"type\": \"video_url\",
            \"video_url\": {
                \"url\": \"https://example.com/video.mp4\"
            },
            \"role\": \"reference_video\"
        },
        {
            \"type\": \"audio_url\",
            \"audio_url\": {
                \"url\": \"https://example.com/audio.mp3\"
            },
            \"role\": \"reference_audio\"
        }
    ],
    \"generate_audio\": true,
    \"ratio\": \"21:9\",
    \"duration\": 11,
    \"watermark\": false
}");
CURLcode ret = curl_easy_perform(hnd);

var client = new RestClient("https://api.quickrouter.ai/api/v3/contents/generations/tasks");
var request = new RestRequest(Method.POST);
request.AddHeader("Accept", "application/json");
request.AddHeader("Authorization", "Bearer YOUR_API_KEY");
request.AddHeader("Content-Type", "application/json");
request.AddParameter("application/json", @"{
    "model": "doubao-seedance-2-0-260128",
    "content": [
        {
            "type": "text",
            "text": "第一人称视角果茶宣传广告..."
        },
        {
            "type": "image_url",
            "image_url": {
                "url": "https://example.com/image1.jpg"
            },
            "role": "reference_image"
        },
        {
            "type": "video_url",
            "video_url": {
                "url": "https://example.com/video.mp4"
            },
            "role": "reference_video"
        },
        {
            "type": "audio_url",
            "audio_url": {
                "url": "https://example.com/audio.mp3"
            },
            "role": "reference_audio"
        }
    ],
    "generate_audio": true,
    "ratio": "21:9",
    "duration": 11,
    "watermark": false
}", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);

#import <Foundation/Foundation.h>

NSURL *url = [NSURL URLWithString:@"https://api.quickrouter.ai/api/v3/contents/generations/tasks"];
NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:url];
[request setHTTPMethod:@"POST"];
[request setValue:@"application/json" forHTTPHeaderField:@"Accept"];
[request setValue:@"Bearer YOUR_API_KEY" forHTTPHeaderField:@"Authorization"];
[request setValue:@"application/json" forHTTPHeaderField:@"Content-Type"];
[request setHTTPBody:[@"{
    \"model\": \"doubao-seedance-2-0-260128\",
    \"content\": [
        {
            \"type\": \"text\",
            \"text\": \"第一人称视角果茶宣传广告...\"
        },
        {
            \"type\": \"image_url\",
            \"image_url\": {
                \"url\": \"https://example.com/image1.jpg\"
            },
            \"role\": \"reference_image\"
        },
        {
            \"type\": \"video_url\",
            \"video_url\": {
                \"url\": \"https://example.com/video.mp4\"
            },
            \"role\": \"reference_video\"
        },
        {
            \"type\": \"audio_url\",
            \"audio_url\": {
                \"url\": \"https://example.com/audio.mp3\"
            },
            \"role\": \"reference_audio\"
        }
    ],
    \"generate_audio\": true,
    \"ratio\": \"21:9\",
    \"duration\": 11,
    \"watermark\": false
}" dataUsingEncoding:NSUTF8StringEncoding]];
NSURLSessionDataTask *task = [[NSURLSession sharedSession] dataTaskWithRequest:request completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {
    NSLog(@"%@", [[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding]);
}];
[task resume];

require "uri"
require "net/http"
require "json"

url = URI("https://api.quickrouter.ai/api/v3/contents/generations/tasks")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Accept"] = "application/json"
request["Authorization"] = "Bearer YOUR_API_KEY"
request["Content-Type"] = "application/json"
request.body = '{
    "model": "doubao-seedance-2-0-260128",
    "content": [
        {
            "type": "text",
            "text": "第一人称视角果茶宣传广告..."
        },
        {
            "type": "image_url",
            "image_url": {
                "url": "https://example.com/image1.jpg"
            },
            "role": "reference_image"
        },
        {
            "type": "video_url",
            "video_url": {
                "url": "https://example.com/video.mp4"
            },
            "role": "reference_video"
        },
        {
            "type": "audio_url",
            "audio_url": {
                "url": "https://example.com/audio.mp3"
            },
            "role": "reference_audio"
        }
    ],
    "generate_audio": true,
    "ratio": "21:9",
    "duration": 11,
    "watermark": false
}'
response = http.request(request)
puts response.read_body

(* Requires cohttp and lwt *)

let url = "https://api.quickrouter.ai/api/v3/contents/generations/tasks" in
let headers = Cohttp.Header.of_list [
  ("Accept", "application/json");
  ("Authorization", "Bearer YOUR_API_KEY");
  ("Content-Type", "application/json");
] in
let body = Cohttp_lwt.Body.of_string '{
    "model": "doubao-seedance-2-0-260128",
    "content": [
        {
            "type": "text",
            "text": "第一人称视角果茶宣传广告..."
        },
        {
            "type": "image_url",
            "image_url": {
                "url": "https://example.com/image1.jpg"
            },
            "role": "reference_image"
        },
        {
            "type": "video_url",
            "video_url": {
                "url": "https://example.com/video.mp4"
            },
            "role": "reference_video"
        },
        {
            "type": "audio_url",
            "audio_url": {
                "url": "https://example.com/audio.mp3"
            },
            "role": "reference_audio"
        }
    ],
    "generate_audio": true,
    "ratio": "21:9",
    "duration": 11,
    "watermark": false
}' in
Lwt_main.run (
  Cohttp_lwt_unix.Client.request ?body:(Some body) ~method_:`POST ~headers (Uri.of_string url)
  >>= fun (resp, body) ->
  Cohttp_lwt.Body.to_string body >|= fun s -> print_endline s
)

import 'package:http/http.dart' as http;
import 'dart:convert';

var headers = {
  "Accept": "application/json",
  "Authorization": "Bearer YOUR_API_KEY",
  "Content-Type": "application/json",
};
var body = json.encode({
    "model": "doubao-seedance-2-0-260128",
    "content": [
        {
            "type": "text",
            "text": "第一人称视角果茶宣传广告..."
        },
        {
            "type": "image_url",
            "image_url": {
                "url": "https://example.com/image1.jpg"
            },
            "role": "reference_image"
        },
        {
            "type": "video_url",
            "video_url": {
                "url": "https://example.com/video.mp4"
            },
            "role": "reference_video"
        },
        {
            "type": "audio_url",
            "audio_url": {
                "url": "https://example.com/audio.mp3"
            },
            "role": "reference_audio"
        }
    ],
    "generate_audio": true,
    "ratio": "21:9",
    "duration": 11,
    "watermark": false
});
var response = await http.post(Uri.parse("https://api.quickrouter.ai/api/v3/contents/generations/tasks"), headers: headers, body: body);
print(response.body);

library(httr)

url <- "https://api.quickrouter.ai/api/v3/contents/generations/tasks"
body <- '{
    "model": "doubao-seedance-2-0-260128",
    "content": [
        {
            "type": "text",
            "text": "第一人称视角果茶宣传广告..."
        },
        {
            "type": "image_url",
            "image_url": {
                "url": "https://example.com/image1.jpg"
            },
            "role": "reference_image"
        },
        {
            "type": "video_url",
            "video_url": {
                "url": "https://example.com/video.mp4"
            },
            "role": "reference_video"
        },
        {
            "type": "audio_url",
            "audio_url": {
                "url": "https://example.com/audio.mp3"
            },
            "role": "reference_audio"
        }
    ],
    "generate_audio": true,
    "ratio": "21:9",
    "duration": 11,
    "watermark": false
}'
response <- post(url, body = body, add_headers("Accept" = "application/json", "Authorization" = "Bearer YOUR_API_KEY", "Content-Type" = "application/json"))
content(response, "text", encoding = "UTF-8")

返回响应

响应参数 🟢 200 OK · application/json

id string

必需

视频生成任务ID，用于后续查询任务状态。

status string

必需

任务状态：submitted 已提交

示例

{
    "id": "cgt-20250918165243-bfpzb",
    "status": "submitted"
}

创建视频生成任务 API（seedance-2.0)

请求参数

请求示例代码

返回响应

相关文档