Seedream 5.0 API

价格

费用 = 每张图片积分 × n。提交任务时预留积分；任务失败，或你在开始前取消，积分全额退回。

速览

快速开始

在控制台创建密钥，然后提交任务并轮询。第二个请求里的 id 换成第一个请求返回的那个。

curl -s -X POST https://api.genmux.tech/v1/generations \
  -H "Authorization: Bearer $API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"model":"seedream-5","prompt":"a red fox in fresh snow, low winter sun","n":1,"resolution":"2K","ratio":"1:1"}'

{
  "id": "0d8b6a3e-2f1c-4a5b-9c1d-7e2f3a4b5c6d",
  "model": "seedream-5",
  "status": "queued",
  "params": {"prompt": "a red fox in fresh snow, low winter sun", "n": 1, "resolution": "2K", "ratio": "1:1"},
  "cost": 16,
  "created_at": "2026-08-30T20:01:12.345Z"
}

curl -s https://api.genmux.tech/v1/generations/0d8b6a3e-2f1c-4a5b-9c1d-7e2f3a4b5c6d \
  -H "Authorization: Bearer $API_KEY"

{
  "id": "0d8b6a3e-2f1c-4a5b-9c1d-7e2f3a4b5c6d",
  "model": "seedream-5",
  "status": "succeeded",
  "cost": 16,
  "images": [
    {"index": 0, "url": "https://…/0.png?X-Amz-Expires=900&…", "expires_at": "2026-08-30T20:16:30Z", "mime": "image/png", "width": 1024, "height": 1024, "bytes": 1843201, "sha256": "9f2c…"}
  ],
  "created_at": "2026-08-30T20:01:12.345Z",
  "finished_at": "2026-08-30T20:01:19.802Z"
}

import os, time, uuid, requests

BASE = "https://api.genmux.tech"
auth = {"Authorization": f"Bearer {os.environ['API_KEY']}"}

job = requests.post(
    f"{BASE}/v1/generations",
    headers={**auth, "Idempotency-Key": str(uuid.uuid4())},
    json={"model": "seedream-5", "prompt": "a red fox in fresh snow, low winter sun", "n": 1, "resolution": "2K", "ratio": "1:1"},
    timeout=30,
).json()

while job["status"] in ("queued", "running"):
    time.sleep(1)
    job = requests.get(f"{BASE}/v1/generations/{job['id']}", headers=auth, timeout=30).json()

print(job["images"][0]["url"])  # presigned, valid for 15 minutes

const BASE = "https://api.genmux.tech";
const auth = { Authorization: `Bearer ${process.env.API_KEY}` };

let job = await fetch(`${BASE}/v1/generations`, {
  method: "POST",
  headers: { ...auth, "Idempotency-Key": crypto.randomUUID(), "Content-Type": "application/json" },
  body: JSON.stringify({ model: "seedream-5", prompt: "a red fox in fresh snow, low winter sun", n: 1, resolution: "2K", ratio: "1:1" }),
}).then((r) => r.json());

while (job.status === "queued" || job.status === "running") {
  await new Promise((r) => setTimeout(r, 1000));
  job = await fetch(`${BASE}/v1/generations/${job.id}`, { headers: auth }).then((r) => r.json());
}

console.log(job.images[0].url); // presigned, valid for 15 minutes

常见问题

Seedream 5.0 API 是什么？

Seedream 5.0 是字节跳动 Seedream 系列的图像模型，团队围绕高分辨率下的写实画面和画面内可读文字来打造它。在 genmux API 上，这套 Seedream API 的模型标识是 "seedream-5"，处在本目录的高分辨率一端：输出 2K, 4K——没有 1K 档——每次请求最多接受 4 张参考图，价格为 2K — 16 积分 · 4K — 18 积分。

一张 Seedream 5.0 图片多少钱？

每张 16 积分起，约合 $0.20，按「Scale」套餐单价计算。价格随分辨率档位变化：2K — 16 积分 · 4K — 18 积分。请求 n 张就是单张价格的 n 倍。积分是预付的，没有订阅费，也不按人头收费。

为什么 Seedream 5.0 没有 1K 选项？

因为上游只以 2K, 4K 提供该模型，所以我们也只能按这些档位报价和计费。因此不传 resolution 字段时默认 2K，请求 1K 会返回 400 validation_error，而不是给你一张悄悄降采样的图。如果你需要更小的素材，请在自己这边把 2K 的输出缩放，或者先用规格表里带 1K 档的模型出草稿——目录里大多数模型都有。

什么时候该用 Seedream 而不是 Nano Banana Pro？

两者都能达到较高的分辨率档位，也都支持参考图，但 Seedream 5.0 的单张价格明显高于 Nano Banana Pro——对照两张价格表就能看到——所以它应当在具体画面上把差价挣回来：写实构图，或者一行文字必须在印刷尺寸下依然干净。Nano Banana Pro 还有 1K 档可以打草稿，本模型没有。实际做法是先在便宜的模型上出草稿，再把满意的那张拿到这里重出：同一个密钥、同一个请求体，只改一个字段。

Seedream 5.0 支持哪些分辨率？

分辨率是档位而不是具体像素：这个模型可输出 2K, 4K，不传 resolution 字段时默认 2K。不在列表内的档位会以 400 validation_error 拒绝，而不是悄悄降采样，所以你始终清楚自己付的是哪一档的价。旧的 size 字段（"1024x1024"）为兼容已有接入仍可使用，会映射到最接近的档位和比例。

可以指定哪些宽高比？

auto, 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3。通过 ratio 字段传入，默认 1:1，"auto" 让模型自己挑选与提示词匹配的画幅。不在列表内的比例会返回 400 validation_error。比例不影响价格，只有分辨率档位影响。

可以传参考图吗（图生图）？

可以。把 images 传成公开 https URL 的数组——每次请求最多 4 张——这时提示词描述的是修改或变体，而不是整个画面；有参考图时提示词本身可选。URL 必须能从公网访问：内网地址和非 https 的 URL 会以 400 validation_error 拒绝。

有反向提示词吗？

有。在 prompt 之外传 negative_prompt，用来描述画面里不想要的东西——瑕疵、文字、水印、想避开的颜色。不额外收费。

一次请求能生成多少张？

每次调用最多 4 张，通过 n 字段指定。每张单独计费，所以在 2K 下 n=4 就是单张价格的 4 倍。要出更大批量请提交多个任务——限制吞吐的是账户在途任务上限（默认 20），不是 n。

生成结果可复现吗？支持随机种子吗？

支持。在提示词之外传一个整数 seed，相同的种子配相同的提示词、分辨率和比例就能复现结果——这也是公平对比两个模型的方法。不传则每次独立采样。

一次生成要多久？必须轮询吗？

从提交到 succeeded 通常 1–20 秒，取决于分辨率档位和队列深度。这套 API 是异步的：POST /v1/generations 在毫秒级返回任务 id，之后你要么轮询 GET /v1/generations/{id}，要么传 webhook_url 让我们在任务完成时 POST 通知你，失败按退避重试最多 8 次直到你的接口返回 2xx。每次投递都带 HMAC-SHA256 签名，用你的账户 webhook 密钥验证。

生成失败会怎样？

不会扣费。积分在任务创建时预留，若任务失败、在排队阶段被取消，或模型暂时不可用（503 model_unavailable），都会全额退回。失败的任务会带一个 error 对象，其中的 code（例如 content_policy）方便你分支处理。

重试时怎么避免重复扣费？

每个 POST /v1/generations 都必须带 Idempotency-Key 请求头。用同一个 key 重发会以 200 返回原来的任务，不会再扣费，所以网络超时可以放心重试。用同一个 key 配不同的请求体会被 422 idempotency_key_mismatch 拒绝。

生成的图片能商用吗？

可以——根据我们的服务条款，我们能转让的权利归你所有，可用于商业用途，前提是提示词和用途符合条款以及上游模型供应商的内容政策。面向客户发布之前请先阅读条款。

延伸阅读

• genmux MCP 服务器：在 Claude、Cursor 和 OpenCode 里出图

  一条 npx 命令安装 @genmux/mcp，让 Claude、Cursor、OpenCode 或 Continue 列出模型、预估费用并生成 Nano Banana 图片。

  2026年9月7日

• 图像生成流水线的速率限制与排队

  设计一条扛得住流量高峰的图像生成流水线：单密钥 RPS、最大在途任务数、客户端排队、退避策略和容量计算。

  2026年8月30日

• Nano Banana 与 Nano Banana Pro：什么时候值得多花一倍

  两个 Nano Banana 模型的实用对比：画质、提示词还原、支持的分辨率、延迟和成本，并按使用场景给出具体建议。

  2026年8月30日

其他模型

同一个密钥、同一种请求格式——改一下 model 字段就能切换。

• Nano Banana API

  nanobanana

  快速的通用文生图与图生图模型，输出 1K，只需一个 HTTP 接口。按张用积分计费，任务失败自动退回积分。

  每张 2 积分 ≈ $0.025 起

• Nano Banana Pro API

  nanobanana-pro

  更高保真度的生成模型，适合主视觉和印刷尺寸的画面，支持 1K、2K 和 4K 输出——1K 档的单张价格约为基础版的两倍。

  每张 4 积分 ≈ $0.05 起

• Qwen-Image 2.0 API

  qwen-image-2

  阿里的 Qwen-Image 2.0——围绕画面内可读文字（包括中文）设计的图像模型，支持参考图输入，输出 1K 或 2K。

  每张 3 积分 ≈ $0.038 起

• Qwen-Image Max API

  qwen-image-max

  Qwen-Image Max——阿里 Qwen-Image 产品线的旗舰，支持参考图输入，输出 1K 和 2K，提供固定的五种宽高比。

  每张 8 积分 ≈ $0.10 起

• Wan 2.7 Image API

  wan-2-7-image

  阿里通义万相系列的 wan2.7-image——文生图与参考图生成，输出 1K 或 2K，与这里其他模型共用同一接口和 API 密钥。

  每张 2 积分 ≈ $0.025 起