豆包 Doubao 图像生成接口 - TimRouter API 转发接口

POST https://api.timrouter.com/v1/images/generations 在线测试 →
Authorization

请在 Header 中加入参数 Authorization,取值为 Bearer 之后拼接令牌

范例: Authorization: Bearer ********************

概述

给定提示和/或传入图像,模型将产出新图像。 相关指南:图像产出 根据提示新建图像。

请求参数项

请求头参数
Authorization string
非必填
范例: Bearer {{YOUR_API_KEY}}
请求体参数 application/json
model string
必填
兼容:文字生成图片 doubao-seedream-3-0-t2i-250415 兼容:图像编辑 doubao-seededit-3-0-i2i-250628 兼容:文字生成图片、图片生成图片 doubao-seedream-5-0-260128 doubao-seedream-4-5-251128 doubao-seedream-4-0-250828
prompt string
必填
用以产出图像的提示词。
image
非必填
传入的图片信息,兼容 URL 或 Base64 编码。 图片URL:请确保图片URL可被进入。 Base64编码:请遵循此格式data:image/<图片格式>;base64,<Base64编码>。留意 <图片格式> 需小写,如 data:image/png;base64,<base64_image>。 Any of: 单图 多图
string
非必填
doubao-seededit-3.0-i2i 仅兼容单图传入。 doubao-seedream-5.0-lite/4.5/4.0 兼容单图。
size
非必填
Any of: seedream-5.0 seedream-4.5 seedream-4.0 seedream-3.0-t2i seededit-3.0-i2i
string
非必填
指定产出图像的尺寸信息,兼容如下两种方式,不可混用。 方式 1 | 指定产出图像的分辨率,并在prompt中用自然语言说明图片宽高比、图片形状或图片用途,最终由模型判断产出图片的大小。 非必填值:2K、3K 方式 2 | 指定产出图像的宽高像素值: 缺省值:2048x2048 总像素取值范围:[2560x1440=3686400, 3072x3072x1.1025=10404496] 宽高比取值范围:[1/16, 16] 建议的宽高像素值: 分辨率 宽高比 宽高像素值 2K 1:1 2048×2048 2K 4:3 2304×1728 2K 3:4 1728×2304 2K 16:9 2848×1600 2K 9:16 1600×2848 2K 3:2 2496×1664 2K 2:3 1664×2496 2K 21:9 3136×1344 3K 1:1 3072×3072 3K 4:3 3456×2592 3K 3:4 2592×3456 3K 16:9 4096×2304 3K 9:16 2304×4096 3K 2:3 2496×3744 3K 3:2 3744×2496 3K 21:9 4704×2016
seed integer
非必填
仅 doubao-seedream-3.0-t2i/seededit-3.0-i2i 兼容该参 随机数种子,用以控制模型产出内容的随机性。取值范围为 [-1, 2147483647]。 留意: 相同的请求下,模型收到不同的seed值,如:不指定seed值或令seed取值为-1(会使用随机数替代)、或手动变更seed值,将产出不同的结果。 相同的请求下,模型收到相同的seed值,会产出类似的结果,但不保证完全一致。
sequential_image_generation string
非必填
仅 doubao-seedream-5.0-lite/4.5/4.0 兼容该参 控制是否关闭组图功能;基于您传入的内容,产出的一组内容关联的图片。 auto:自动判断模式,模型会根据用户带来的提示词自主判断是否返回组图及组图包括的图片数量。 disabled:关闭组图功能,模型只会产出一张图。 缺省值 disabled
sequential_image_generation_options object
非必填
仅 doubao-seedream-5.0-lite/4.5/4.0 兼容该参 组图功能的设定。仅当 sequential_image_generation 为 auto 时生效。
max_images integer
非必填
指定本次请求,最多可产出的图片数量,取值范围: [1, 15] 缺省值 15
guidance_scale number
非必填
模型产出结果与prompt的一致程度,产出图像的自由度,又称为文本权重;值越大,模型自由度越小,与用户传入的提示词相关性越强,取值范围:[1, 10] 。 doubao-seedream-3.0-t2i 缺省值 2.5 doubao-seededit-3.0-i2i 缺省值 5.5 doubao-seedream-5.0-lite/4.5/4.0 不兼容
output_format string
非必填
仅 doubao-seedream-5.0 兼容该参 指定产出图像的文件格式。非必填值:
png
非必填
jpeg
非必填
缺省值 jpeg
response_format string
非必填
指定产出图像的返回格式。兼容如下两种返回方式: url:返回图片获取下载链接;链接在图像生成后24小时内有效,请及时获取下载图片。 b64_json:以 Base64 编码字符串的 JSON 格式返回图像数据。 缺省值 url
watermark boolean
非必填
是否在产出的图片中添加水印。 false:不添加水印。 true:在图片右下角添加“AI产出”字样的水印标识。 缺省值 true seedream-5.0/4.5/4.0 - 文字生成图片 seedream-5.0/4.5/4.0 - 图片生成图片 seedream-5.0/4.5/4.0 - 多图融合 seedream-5.0/4.5/4.0 - 多参照图生图 seedream-3.0-t2i seededit-3.0-i2i { "model": "doubao-seedream-5-0-260128", "prompt": "充满活力的特写编辑肖像,模特眼神犀利,头戴雕塑感帽子,色彩拼接丰富,眼部焦点锐利,景深较浅,具有Vogue杂志封面的美学风格,采用中画幅拍摄,工作室灯光效果强烈。", "size": "2K", "output_format": "png", "response_format": "url", "watermark": false } 请求
范例
{
    "model": "doubao-seedream-5-0-260128",
    "prompt": "充满活力的特写编辑肖像,模特眼神犀利,头戴雕塑感帽子,色彩拼接丰富,眼部焦点锐利,景深较浅,具有Vogue杂志封面的美学风格,采用中画幅拍摄,工作室灯光效果强烈。",
    "size": "2K",
    "output_format": "png",
    "response_format": "url",
    "watermark": false
}

请求代码示例

curl --location --request POST 'https://api.timrouter.com/v1/images/generations' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "doubao-seedream-5-0-260128",
    "prompt": "充满活力的特写编辑肖像,模特眼神犀利,头戴雕塑感帽子,色彩拼接丰富,眼部焦点锐利,景深较浅,具有Vogue杂志封面的美学风格,采用中画幅拍摄,工作室灯光效果强烈。",
    "size": "2K",
    "output_format": "png",
    "response_format": "url",
    "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-seedream-5-0-260128",
    "prompt": "充满活力的特写编辑肖像,模特眼神犀利,头戴雕塑感帽子,色彩拼接丰富,眼部焦点锐利,景深较浅,具有Vogue杂志封面的美学风格,采用中画幅拍摄,工作室灯光效果强烈。",
    "size": "2K",
    "output_format": "png",
    "response_format": "url",
    "watermark": false
});

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

fetch("https://api.timrouter.com/v1/images/generations", 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.timrouter.com/v1/images/generations");
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-seedream-5-0-260128\",
    \"prompt\": \"充满活力的特写编辑肖像,模特眼神犀利,头戴雕塑感帽子,色彩拼接丰富,眼部焦点锐利,景深较浅,具有Vogue杂志封面的美学风格,采用中画幅拍摄,工作室灯光效果强烈。\",
    \"size\": \"2K\",
    \"output_format\": \"png\",
    \"response_format\": \"url\",
    \"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.timrouter.com/v1/images/generations"
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-seedream-5-0-260128\",
    \"prompt\": \"充满活力的特写编辑肖像,模特眼神犀利,头戴雕塑感帽子,色彩拼接丰富,眼部焦点锐利,景深较浅,具有Vogue杂志封面的美学风格,采用中画幅拍摄,工作室灯光效果强烈。\",
    \"size\": \"2K\",
    \"output_format\": \"png\",
    \"response_format\": \"url\",
    \"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-seedream-5-0-260128",
    "prompt": "充满活力的特写编辑肖像,模特眼神犀利,头戴雕塑感帽子,色彩拼接丰富,眼部焦点锐利,景深较浅,具有Vogue杂志封面的美学风格,采用中画幅拍摄,工作室灯光效果强烈。",
    "size": "2K",
    "output_format": "png",
    "response_format": "url",
    "watermark": false
}`)
    req, _ := http.NewRequest("POST", "https://api.timrouter.com/v1/images/generations", 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.timrouter.com/v1/images/generations',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS => '{
    "model": "doubao-seedream-5-0-260128",
    "prompt": "充满活力的特写编辑肖像,模特眼神犀利,头戴雕塑感帽子,色彩拼接丰富,眼部焦点锐利,景深较浅,具有Vogue杂志封面的美学风格,采用中画幅拍摄,工作室灯光效果强烈。",
    "size": "2K",
    "output_format": "png",
    "response_format": "url",
    "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.timrouter.com")
payload = json.dumps({
    "model": "doubao-seedream-5-0-260128",
    "prompt": "充满活力的特写编辑肖像,模特眼神犀利,头戴雕塑感帽子,色彩拼接丰富,眼部焦点锐利,景深较浅,具有Vogue杂志封面的美学风格,采用中画幅拍摄,工作室灯光效果强烈。",
    "size": "2K",
    "output_format": "png",
    "response_format": "url",
    "watermark": false
})
headers = {
   'Accept': 'application/json',
   'Authorization': 'Bearer YOUR_API_KEY',
   'Content-Type': 'application/json',
}
conn.request("POST", "/v1/images/generations", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
POST https://api.timrouter.com/v1/images/generations HTTP/1.1
Accept: application/json
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{
    "model": "doubao-seedream-5-0-260128",
    "prompt": "充满活力的特写编辑肖像,模特眼神犀利,头戴雕塑感帽子,色彩拼接丰富,眼部焦点锐利,景深较浅,具有Vogue杂志封面的美学风格,采用中画幅拍摄,工作室灯光效果强烈。",
    "size": "2K",
    "output_format": "png",
    "response_format": "url",
    "watermark": false
}
CURL *hnd = curl_easy_init();
curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "POST");
curl_easy_setopt(hnd, CURLOPT_URL, "https://api.timrouter.com/v1/images/generations");

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-seedream-5-0-260128\",
    \"prompt\": \"充满活力的特写编辑肖像,模特眼神犀利,头戴雕塑感帽子,色彩拼接丰富,眼部焦点锐利,景深较浅,具有Vogue杂志封面的美学风格,采用中画幅拍摄,工作室灯光效果强烈。\",
    \"size\": \"2K\",
    \"output_format\": \"png\",
    \"response_format\": \"url\",
    \"watermark\": false
}");
CURLcode ret = curl_easy_perform(hnd);
var client = new RestClient("https://api.timrouter.com/v1/images/generations");
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-seedream-5-0-260128",
    "prompt": "充满活力的特写编辑肖像,模特眼神犀利,头戴雕塑感帽子,色彩拼接丰富,眼部焦点锐利,景深较浅,具有Vogue杂志封面的美学风格,采用中画幅拍摄,工作室灯光效果强烈。",
    "size": "2K",
    "output_format": "png",
    "response_format": "url",
    "watermark": false
}", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);
#import <Foundation/Foundation.h>

NSURL *url = [NSURL URLWithString:@"https://api.timrouter.com/v1/images/generations"];
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-seedream-5-0-260128\",
    \"prompt\": \"充满活力的特写编辑肖像,模特眼神犀利,头戴雕塑感帽子,色彩拼接丰富,眼部焦点锐利,景深较浅,具有Vogue杂志封面的美学风格,采用中画幅拍摄,工作室灯光效果强烈。\",
    \"size\": \"2K\",
    \"output_format\": \"png\",
    \"response_format\": \"url\",
    \"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.timrouter.com/v1/images/generations")
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-seedream-5-0-260128",
    "prompt": "充满活力的特写编辑肖像,模特眼神犀利,头戴雕塑感帽子,色彩拼接丰富,眼部焦点锐利,景深较浅,具有Vogue杂志封面的美学风格,采用中画幅拍摄,工作室灯光效果强烈。",
    "size": "2K",
    "output_format": "png",
    "response_format": "url",
    "watermark": false
}'
response = http.request(request)
puts response.read_body
(* Requires cohttp and lwt *)

let url = "https://api.timrouter.com/v1/images/generations" 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-seedream-5-0-260128",
    "prompt": "充满活力的特写编辑肖像,模特眼神犀利,头戴雕塑感帽子,色彩拼接丰富,眼部焦点锐利,景深较浅,具有Vogue杂志封面的美学风格,采用中画幅拍摄,工作室灯光效果强烈。",
    "size": "2K",
    "output_format": "png",
    "response_format": "url",
    "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-seedream-5-0-260128",
    "prompt": "充满活力的特写编辑肖像,模特眼神犀利,头戴雕塑感帽子,色彩拼接丰富,眼部焦点锐利,景深较浅,具有Vogue杂志封面的美学风格,采用中画幅拍摄,工作室灯光效果强烈。",
    "size": "2K",
    "output_format": "png",
    "response_format": "url",
    "watermark": false
});
var response = await http.post(Uri.parse("https://api.timrouter.com/v1/images/generations"), headers: headers, body: body);
print(response.body);
library(httr)

url <- "https://api.timrouter.com/v1/images/generations"
body <- '{
    "model": "doubao-seedream-5-0-260128",
    "prompt": "充满活力的特写编辑肖像,模特眼神犀利,头戴雕塑感帽子,色彩拼接丰富,眼部焦点锐利,景深较浅,具有Vogue杂志封面的美学风格,采用中画幅拍摄,工作室灯光效果强烈。",
    "size": "2K",
    "output_format": "png",
    "response_format": "url",
    "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
image
非必填
application/json
created integer
必填
data array [object]
必填
url string
必填
{ "created": 1749819664, "data": [ { "content_filter_results": { "hate": { "filtered": false, "severity": "safe" }, "self_harm": { "filtered": false, "severity": "safe" }, "sexual": { "filtered": false, "severity": "safe" }, "violence": { "filtered": false, "severity": "safe" } }, "prompt_filter_results": { "hate": { "filtered": false, "severity": "safe" }, "profanity": { "detected": false, "filtered": false }, "self_harm": { "filtered": false, "severity": "safe" }, "sexual": { "filtered": false, "severity": "safe" }, "violence": { "filtered": false, "severity": "safe" } }, "revised_prompt": "A young, adorable sea otter floating in the ocean", "url": "https://dalleproduse.blob.core.windows.net/private/images/6b0ee3bd-fe24-46c7-8ab8-85be87b00eaf/generated_00.png?se=2025-06-14T13%3A01%3A13Z&sig=9pLM1cLo1Af6FKRZc2AZSVxfSQBBBIyzfg0cOiT7C%2B0%3D&ske=2025-06-13T23%3A43%3A31Z&skoid=09ba021e-c417-441c-b203-c81e5dcd7b7f&sks=b&skt=2025-06-06T23%3A43%3A31Z&sktid=33e01921-4d64-4f8c-a055-5bdaffd5e33d&skv=2020-10-02&sp=r&spr=https&sr=b&sv=2020-10-02" } ] }
范例
{
    "created": 1749819664,
    "data": [
        {
            "content_filter_results": {
                "hate": {
                    "filtered": false,
                    "severity": "safe"
                },
                "self_harm": {
                    "filtered": false,
                    "severity": "safe"
                },
                "sexual": {
                    "filtered": false,
                    "severity": "safe"
                },
                "violence": {
                    "filtered": false,
                    "severity": "safe"
                }
            },
            "prompt_filter_results": {
                "hate": {
                    "filtered": false,
                    "severity": "safe"
                },
                "profanity": {
                    "detected": false,
                    "filtered": false
                },
                "self_harm": {
                    "filtered": false,
                    "severity": "safe"
                },
                "sexual": {
                    "filtered": false,
                    "severity": "safe"
                },
                "violence": {
                    "filtered": false,
                    "severity": "safe"
                }
            },
            "revised_prompt": "A young, adorable sea otter floating in the ocean",
            "url": "https://dalleproduse.blob.core.windows.net/private/images/6b0ee3bd-fe24-46c7-8ab8-85be87b00eaf/generated_00.png?se=2025-06-14T13%3A01%3A13Z&sig=9pLM1cLo1Af6FKRZc2AZSVxfSQBBBIyzfg0cOiT7C%2B0%3D&ske=2025-06-13T23%3A43%3A31Z&skoid=09ba021e-c417-441c-b203-c81e5dcd7b7f&sks=b&skt=2025-06-06T23%3A43%3A31Z&sktid=33e01921-4d64-4f8c-a055-5bdaffd5e33d&skv=2020-10-02&sp=r&spr=https&sr=b&sv=2020-10-02"
        }
    ]
}

常见异常

  • 401 鉴权未成功:检查 API Key 是否无误
  • 429 请求限流:降低请求频率或升级套餐
  • 500 服务器异常:稍后重试

重要提示

  • 请确保 API Key 有足够的余额
  • 请求频率受 API 限制,请参考定价页面