豆包 Doubao 视频生成接口 - QuickRouter API 中转接口
▼
Authorization
在 Header 添加参数 Authorization,其值为 Bearer 之后拼接 Token
示例:
Authorization: Bearer ********************
官方文档:https://www.volcengine.com/docs/82379/1520757
请求参数
Header 参数
Content-Type
string
可选
示例: application/json
Accept
string
可选
示例: application/json
Authorization
string
可选
示例: Bearer {{YOUR_API_KEY}}
Body 参数 application/json
model
string
必需
doubao-seedance-1-5-pro-251215 支持:文生、首帧、首尾帧 doubao-seedance-1-0-pro-250528 支持:文生、首帧、首尾帧 doubao-seedance-1-0-pro-fast-251015 支持:文生、首帧 doubao-seedance-1-0-lite-t2v-250428 支持:文生 doubao-seedance-1-0-lite-i2v-250428 支持:首帧、首尾帧、参考图(1-4)
content
array [object]
必需
输入给模型,生成视频的信息,支持文本信息和图片信息。
type
string
必需
输入内容的类型: text 表示文本 image_url 表示图片
text
string
必需
输入给模型的文本内容,描述期望生成的视频,包括: 文本提示词(必填):支持中英文。建议不超过500字。字数过多信息容易分散,模型可能因此忽略细节,只关注重点,造成视频缺失部分元素。
image_url
object
可选
输入给模型的图片对象。
role
string
可选
图片用途: reference_image 表示参考图 first_frame 表示首帧 只为首帧的时候该参数可不填 last_frame 表示尾帧
generate_audio
boolean
可选
控制生成的视频是否包含与画面同步的声音。 true:模型输出的视频包含同步音频。Seedance 1.5 pro 能够基于文本提示词与视觉内容,自动生成与之匹配的人声、音效及背景音乐。建议将对话部分置于双引号内,以优化音频生成效果。例如:男人叫住女人说:“你记住,以后不可以用手指指月亮。” false:模型输出的视频为无声视频。 注意:该参数只支持 Seedance 1.5 pro 模型 默认值:true -- 参数
object
可选
以下参数需要添加到提示词后面 通过 -- 形式追加,参考示例
resolution
string
可选
视频分辨率,枚举值: 480p 720p 1080p:参考图场景不支持 Seedance 1.5 pro、Seedance 1.0 lite 默认值:720p Seedance 1.0 pro & pro-fast 默认值:1080p
ratio
string
可选
生成视频的宽高比例: 16:9 4:3 1:1 3:4 9:16 21:9 文生视频:默认值 16:9( Seedance 1.5 Pro 默认为 自适应) 图生视频:默认 自适应(参考图生视频场景默认值为 16:9)
duration
integer
可选
生成视频时长,单位:秒。支持 2-12 秒 Seedance 1.5 pro 只支持 4-12 秒 默认值 5
camera_fixed
string
可选
是否固定摄像头。枚举值: true:固定摄像头。平台会在用户提示词中追加固定摄像头,实际效果不保证。 false:不固定摄像头。 注意:参考图场景不支 默认值 false
watermark
string
可选
生成视频是否包含水印。枚举值: false:不含水印。 true:含有水印。 默认值 false
seed
integer
可选
种子整数,用于控制生成内容的随机性。 取值范围:[-1, 2^32-1]之间的整数。 注意: 相同的请求下,模型收到不同的seed值,如:不指定seed值或令seed取值为-1(会使用随机数替代)、或手动变更seed值,将生成不同的结果。 相同的请求下,模型收到相同的seed值,会生成类似的结果,但不保证完全一致。 默认值 -1 传入时不能输入 -1 文生视频 图生视频-首帧 图生视频-首尾帧 图生视频-参考图 图生视频-base64编码 { "model": "doubao-seedance-1-0-pro-fast-251015", "content": [ { "type": "text", "text": "写实风格,晴朗的蓝天之下,一大片白色的雏菊花田,镜头逐渐拉近,最终定格在一朵雏菊花的特写上,花瓣上有几颗晶莹的露珠 --resolution 480p --ratio 16:9 --duration 2 --camera_fixed false --watermark false --seed 1" } ] } 请求
示例
{
"model": "doubao-seedance-1-0-pro-fast-251015",
"content": [
{
"type": "text",
"text": "写实风格,晴朗的蓝天之下,一大片白色的雏菊花田,镜头逐渐拉近,最终定格在一朵雏菊花的特写上,花瓣上有几颗晶莹的露珠 --resolution 480p --ratio 16:9 --duration 2 --camera_fixed false --watermark false --seed 1"
}
]
}
请求示例代码
curl --location --request POST 'https://api.quickrouter.ai/volc/v1/contents/generations/tasks' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
"model": "doubao-seedance-1-0-pro-fast-251015",
"content": [
{
"type": "text",
"text": "写实风格,晴朗的蓝天之下,一大片白色的雏菊花田,镜头逐渐拉近,最终定格在一朵雏菊花的特写上,花瓣上有几颗晶莹的露珠 --resolution 480p --ratio 16:9 --duration 2 --camera_fixed false --watermark false --seed 1"
}
]
}'
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-1-0-pro-fast-251015",
"content": [
{
"type": "text",
"text": "写实风格,晴朗的蓝天之下,一大片白色的雏菊花田,镜头逐渐拉近,最终定格在一朵雏菊花的特写上,花瓣上有几颗晶莹的露珠 --resolution 480p --ratio 16:9 --duration 2 --camera_fixed false --watermark false --seed 1"
}
]
});
var requestOptions = {
method: 'POST',
headers: myHeaders,
body: raw,
redirect: 'follow'
};
fetch("https://api.quickrouter.ai/volc/v1/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/volc/v1/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-1-0-pro-fast-251015\",
\"content\": [
{
\"type\": \"text\",
\"text\": \"写实风格,晴朗的蓝天之下,一大片白色的雏菊花田,镜头逐渐拉近,最终定格在一朵雏菊花的特写上,花瓣上有几颗晶莹的露珠 --resolution 480p --ratio 16:9 --duration 2 --camera_fixed false --watermark false --seed 1\"
}
]
}";
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/volc/v1/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-1-0-pro-fast-251015\",
\"content\": [
{
\"type\": \"text\",
\"text\": \"写实风格,晴朗的蓝天之下,一大片白色的雏菊花田,镜头逐渐拉近,最终定格在一朵雏菊花的特写上,花瓣上有几颗晶莹的露珠 --resolution 480p --ratio 16:9 --duration 2 --camera_fixed false --watermark false --seed 1\"
}
]
}"
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-1-0-pro-fast-251015",
"content": [
{
"type": "text",
"text": "写实风格,晴朗的蓝天之下,一大片白色的雏菊花田,镜头逐渐拉近,最终定格在一朵雏菊花的特写上,花瓣上有几颗晶莹的露珠 --resolution 480p --ratio 16:9 --duration 2 --camera_fixed false --watermark false --seed 1"
}
]
}`)
req, _ := http.NewRequest("POST", "https://api.quickrouter.ai/volc/v1/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/volc/v1/contents/generations/tasks',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_POSTFIELDS => '{
"model": "doubao-seedance-1-0-pro-fast-251015",
"content": [
{
"type": "text",
"text": "写实风格,晴朗的蓝天之下,一大片白色的雏菊花田,镜头逐渐拉近,最终定格在一朵雏菊花的特写上,花瓣上有几颗晶莹的露珠 --resolution 480p --ratio 16:9 --duration 2 --camera_fixed false --watermark false --seed 1"
}
]
}',
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-1-0-pro-fast-251015",
"content": [
{
"type": "text",
"text": "写实风格,晴朗的蓝天之下,一大片白色的雏菊花田,镜头逐渐拉近,最终定格在一朵雏菊花的特写上,花瓣上有几颗晶莹的露珠 --resolution 480p --ratio 16:9 --duration 2 --camera_fixed false --watermark false --seed 1"
}
]
})
headers = {
'Accept': 'application/json',
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json',
}
conn.request("POST", "/volc/v1/contents/generations/tasks", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
POST https://api.quickrouter.ai/volc/v1/contents/generations/tasks HTTP/1.1
Accept: application/json
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
{
"model": "doubao-seedance-1-0-pro-fast-251015",
"content": [
{
"type": "text",
"text": "写实风格,晴朗的蓝天之下,一大片白色的雏菊花田,镜头逐渐拉近,最终定格在一朵雏菊花的特写上,花瓣上有几颗晶莹的露珠 --resolution 480p --ratio 16:9 --duration 2 --camera_fixed false --watermark false --seed 1"
}
]
}
CURL *hnd = curl_easy_init();
curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "POST");
curl_easy_setopt(hnd, CURLOPT_URL, "https://api.quickrouter.ai/volc/v1/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-1-0-pro-fast-251015\",
\"content\": [
{
\"type\": \"text\",
\"text\": \"写实风格,晴朗的蓝天之下,一大片白色的雏菊花田,镜头逐渐拉近,最终定格在一朵雏菊花的特写上,花瓣上有几颗晶莹的露珠 --resolution 480p --ratio 16:9 --duration 2 --camera_fixed false --watermark false --seed 1\"
}
]
}");
CURLcode ret = curl_easy_perform(hnd);
var client = new RestClient("https://api.quickrouter.ai/volc/v1/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-1-0-pro-fast-251015",
"content": [
{
"type": "text",
"text": "写实风格,晴朗的蓝天之下,一大片白色的雏菊花田,镜头逐渐拉近,最终定格在一朵雏菊花的特写上,花瓣上有几颗晶莹的露珠 --resolution 480p --ratio 16:9 --duration 2 --camera_fixed false --watermark false --seed 1"
}
]
}", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);
#import <Foundation/Foundation.h>
NSURL *url = [NSURL URLWithString:@"https://api.quickrouter.ai/volc/v1/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-1-0-pro-fast-251015\",
\"content\": [
{
\"type\": \"text\",
\"text\": \"写实风格,晴朗的蓝天之下,一大片白色的雏菊花田,镜头逐渐拉近,最终定格在一朵雏菊花的特写上,花瓣上有几颗晶莹的露珠 --resolution 480p --ratio 16:9 --duration 2 --camera_fixed false --watermark false --seed 1\"
}
]
}" 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/volc/v1/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-1-0-pro-fast-251015",
"content": [
{
"type": "text",
"text": "写实风格,晴朗的蓝天之下,一大片白色的雏菊花田,镜头逐渐拉近,最终定格在一朵雏菊花的特写上,花瓣上有几颗晶莹的露珠 --resolution 480p --ratio 16:9 --duration 2 --camera_fixed false --watermark false --seed 1"
}
]
}'
response = http.request(request)
puts response.read_body
(* Requires cohttp and lwt *)
let url = "https://api.quickrouter.ai/volc/v1/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-1-0-pro-fast-251015",
"content": [
{
"type": "text",
"text": "写实风格,晴朗的蓝天之下,一大片白色的雏菊花田,镜头逐渐拉近,最终定格在一朵雏菊花的特写上,花瓣上有几颗晶莹的露珠 --resolution 480p --ratio 16:9 --duration 2 --camera_fixed false --watermark false --seed 1"
}
]
}' 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-1-0-pro-fast-251015",
"content": [
{
"type": "text",
"text": "写实风格,晴朗的蓝天之下,一大片白色的雏菊花田,镜头逐渐拉近,最终定格在一朵雏菊花的特写上,花瓣上有几颗晶莹的露珠 --resolution 480p --ratio 16:9 --duration 2 --camera_fixed false --watermark false --seed 1"
}
]
});
var response = await http.post(Uri.parse("https://api.quickrouter.ai/volc/v1/contents/generations/tasks"), headers: headers, body: body);
print(response.body);
library(httr)
url <- "https://api.quickrouter.ai/volc/v1/contents/generations/tasks"
body <- '{
"model": "doubao-seedance-1-0-pro-fast-251015",
"content": [
{
"type": "text",
"text": "写实风格,晴朗的蓝天之下,一大片白色的雏菊花田,镜头逐渐拉近,最终定格在一朵雏菊花的特写上,花瓣上有几颗晶莹的露珠 --resolution 480p --ratio 16:9 --duration 2 --camera_fixed false --watermark false --seed 1"
}
]
}'
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
object
可选
{ "id": "cgt-20250918165243-bfpzb", "status": "submitted" }
示例
{
"id": "cgt-20250918165243-bfpzb",
"status": "submitted"
}