Seedream 4.0 (豆包)

字节跳动即梦系列闭源模型，中文场景理解优秀。支持 1K / 2K / 4K 分辨率输出，可通过参考图片进行图生图。

参考图上传提示:生成接口不再接收内联 base64 图片数据。请先使用文件上传接口上传图片获取 URL，再把 URL 放进 images。

调用示例

curl https://cokeapi.com/v1/images/generations \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedream-4-0",
    "prompt": "一只在京都樱花树下的赛博狐狸，电影质感，Portra 400 胶片",
    "size": "16:9",
    "n": 1,
    "metadata": {
      "resolution": "2K"
    }
  }'

curl https://cokeapi.com/v1/images/generations \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedream-4-0",
    "prompt": "把背景换成赛博朋克霓虹街道，保留主体",
    "size": "1:1",
    "n": 1,
    "images": ["https://cdn.cokeapi.com/uploads/2026/05/17/photo.png"],
    "metadata": {
      "resolution": "2K"
    }
  }'

curl https://cokeapi.com/v1/images/generations \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedream-4-0",
    "prompt": "可爱的熊猫在竹林中玩耍",
    "size": "1:1",
    "n": 3,
    "images": ["https://cdn.cokeapi.com/uploads/2026/05/17/panda.png"],
    "metadata": {
      "resolution": "4K",
      "optimize_prompt_options": { "mode": "standard" },
      "sequential_image_generation": "auto",
      "sequential_image_generation_options": { "max_images": 3 },
      "watermark": false
    }
  }'

from openai import OpenAI

client = OpenAI(
    base_url="https://cokeapi.com/v1",
    api_key="sk-xxxxxxxx",
)

img = client.images.generate(
    model="doubao-seedream-4-0",
    prompt="一只在京都樱花树下的赛博狐狸，电影质感",
    size="16:9",
    n=1,
    extra_body={"metadata": {"resolution": "2K"}},
)

print(img.data[0].url)

from openai import OpenAI

client = OpenAI(
    base_url="https://cokeapi.com/v1",
    api_key="sk-xxxxxxxx",
)

img = client.images.generate(
    model="doubao-seedream-4-0",
    prompt="把背景换成赛博朋克霓虹街道，保留主体",
    n=1,
    images=["https://cdn.cokeapi.com/uploads/2026/05/17/photo.png"],
    extra_body={"metadata": {"resolution": "2K"}},
)

print(img.data[0].url)

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://cokeapi.com/v1",
  apiKey: process.env.COKEAPI_KEY,
});

const img = await client.images.generate({
  model: "doubao-seedream-4-0",
  prompt: "一只在京都樱花树下的赛博狐狸，电影质感",
  size: "16:9",
  n: 1,
  metadata: { resolution: "2K" },
});

console.log(img.data[0].url);

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://cokeapi.com/v1",
  apiKey: process.env.COKEAPI_KEY,
});

const img = await client.images.generate({
  model: "doubao-seedream-4-0",
  prompt: "把背景换成赛博朋克霓虹街道，保留主体",
  n: 1,
  images: ["https://cdn.cokeapi.com/uploads/2026/05/17/photo.png"],
  metadata: { resolution: "2K" },
});

console.log(img.data[0].url);

请求参数

参数	类型	必填	默认值	说明
model	string	是	—	固定为 `doubao-seedream-4-0`
prompt	string	是	—	文本描述，最长 1000 字符，中文效果尤佳
size	string	否	1:1	画面比例：`1:1` / `4:3` / `3:4` / `16:9` / `9:16` / `3:2` / `2:3` / `21:9` / `9:21` / `auto`（自动匹配参考图比例）
n	int	否	1	一次出图数量，1–15（参考图 + 生成图总数 ≤ 15）
images	string[]	否	—	参考图 URL 列表，用于图生图，最多 10 张
metadata	object	否	—	高级配置，见下方

metadata 参数

参数	类型	默认值	说明
metadata.resolution	string	`2K`	分辨率：`1K` / `2K`（标准）/ `4K`（高清）
metadata.optimize_prompt_options	object	—	提示词优化选项
metadata.optimize_prompt_options.mode	string	`standard`	`standard`（标准，质量更高）/ `fast`（快速，质量一般）
metadata.sequential_image_generation	string	`disabled`	顺序生成：`disabled`（禁用）/ `auto`（启用多图生成）
metadata.sequential_image_generation_options	object	—	顺序生成选项
metadata.sequential_image_generation_options.max_images	int	—	生成图像数量，1–15
metadata.watermark	bool	true	是否添加水印

分辨率参考尺寸

分辨率	1:1	16:9
1K	1024×1024	1280×720
2K	2048×2048	2560×1440
4K	4096×4096	5404×3040

image_urls 限制

项目	限制
最大数量	10 张
格式	JPEG / PNG
宽高比	宽/高 ∈ [1/3, 3]
最小尺寸	宽度 > 14px，高度 > 14px
单张大小	≤ 10MB
总像素	≤ 6000×6000px

响应示例

创建成功后立即返回任务状态，后续通过异步任务查询结果：

{
  "id": "img_01HX...",
  "object": "generation.task",
  "status": "queued",
  "created_at": 1718000000,
  "model": "doubao-seedream-4-0",
  "progress": 0
}

计费

按 图片张数 扣费，单价 $0.046 / 张（不区分分辨率档位）。完整实时价目以模型列表页为准，本页价格为 2026-07 快照。失败请求（含上游 502）全额退款，不计费。

错误码

code	type	含义	HTTP
400101	`invalid_param`	参数错误（尺寸不支持等）	400
400401	`insufficient_balance`	余额不足	400
401104	`api_key_invalid`	API Key 无效	401
429101	`rate_limit_exceeded`	RPM 超限	429
429302	`daily_quota_exceeded`	每日调用配额耗尽	429
502201	`upstream_unavailable`	ByteDance 服务暂不可用	502
502203	`no_available_account`	暂无可用账号	502

完整列表见错误码。

注意事项

CDN 图片 URL 24 小时后失效，需长期保存请下载到自有存储。
失败请求（含上游 502）全额返还本次扣费，不计费。

本页目录