如何使用 Seedgream 4.5 API

CometAPI
AnnaDec 9, 2025
如何使用 Seedgream 4.5 API

Seedream 4.5 是 Seedream 文本到图像/图像编辑模型家族(由 Byte/BytePlus 研究开发)的最新进化版本。它正通过官方 BytePlus 端点以及多个第三方平台逐步上线——包括通过诸如 CometAPI 的多模型网关实现集成访问——并带来更好的主体一致性、版式/文字渲染,以及多图编辑的保真度。

本文是使用 Seedream 4.5 API 的动手型专业指南。你将获得实用的环境搭建步骤、认证与请求模式、提示词与参数最佳实践、编辑与多图工作流、错误处理、部署模式,以及法律/安全注意事项。

What is Seedream 4.5?

Seedream 4.5 是 Seedream 家族的最新迭代——一款用于高保真文本到图像生成与上下文感知图像编辑的多模态模型(image-to-image、multi-reference editing、inpainting/outpainting、版式与密集文本处理)。与早期 Seedream 版本相比,4.5 着重提升了多图工作流中的主体一致性、更严格地保留参考细节、更高的版式保真度(图像中的文字),并在“高质量”设置下将输出质量提升至 4K/超高清。这些改进得益于规模化架构以及更新的提示词调优/引擎侧启发式。

为什么这很重要:4.5 专为专业创作任务打造——批量产品变体、品牌一致的多图编辑、高分辨率印刷资产——同时通过参考图与专项编辑操作提供更精细的控制。

Core capabilities

  • 文本到图像生成(单次与批量):每次 API 调用可生成 1–15 张图像,支持可选质量模式(Basic 与 High),在速度与分辨率之间做权衡。
  • **图像编辑(i2i/inpainting/outpainting):**可使用一个或多个参考图;在多参考场景中保留细节与空间关系。
  • **多参考融合与元素复制:**单次任务可使用最多约 ~10 张参考图来移植元素,同时保持光照/视角一致。
  • **高水平版式/密集文本渲染:**更好地处理包含文字或标识的图像(适用于样机、产品标签、UI 截图)。
  • **流式/渐进式输出:**部分部署端点支持流式返回,使客户端在生成过程中接收阶段性结果。

How do I Use Seedream 4.5 API through CometAPI?

下面是一份可直接复制粘贴的实操指南,通过 CometAPI 生成图像(一个聚合器,将 Seedream 4.5 作为模型参数暴露)。当你希望用一个 API Key 访问数十/上百种模型,并获得稳定、易集成的 REST 接口时,可使用 CometAPI。CometAPI 文档展示了 doubao-seedream-4-5-251128 模型别名与标准的图像生成端点。

总体步骤

  1. 注册 CometAPI 并获取 API Key。
  2. 使用图像生成端点(POST https://api.cometapi.com/v1/images/generations),将 model 参数设为 Seedream 4.5 的标识(示例:doubao-seedream-4-5-251128)。
  3. 包含提示词、可选的参考图(按聚合器支持使用 URL 或 multipart 上传)、输出尺寸/质量,以及其他参数。
  4. 接收包含生成图像 URL(或 base64)及元数据的 JSON 响应。

Request types and modes

Seedream 4.5 通常支持:

  • 文本 → 图像(文本提示词 → 新图)
  • 图像 → 图像(参考图 + 提示词进行风格化变换)
  • 图像编辑/局部修补(Inpainting)(提供遮罩 + 编辑指令进行定点修改)
    托管 API 支持异步任务模式(提交任务 → 使用 taskId 轮询),适用于耗时渲染与批量工作流。生成的链接通常是时效性的(例如在部分网关上有效期为 24 小时),因此需规划存储/导出。

curl example (text-to-image, single prompt)

curl -X POST "https://api.cometapi.com/v1/images/generations" \
  -H "Authorization: Bearer COMETAPI_KEY_GOES_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedream-4-5-251128",
    "prompt": "A cinematic portrait of a cyberpunk fox in neon rain, 4k, detailed lighting, film grain",
    "n": 3,
    "width": 2048,
    "height": 2048,
    "quality": "high",     # or "basic"
    "seed": 12345,
    "style": "photorealistic"
  }'

Notes

  • COMETAPI_KEY_GOES_HERE 替换为你的 CometAPI Key。
  • n 参数可在一次调用中生成多个变体(减少开销)。
  • quality: "high" 通常对应更高分辨率/更高算力成本(往往支持 4K)。

Python requests example (text-to-image + saving results)

import requests, base64, os

API_URL = "https://api.cometapi.com/v1/images/generations"
API_KEY = os.environ.get("COMETAPI_KEY")  # set env var for safety

payload = {
  "model": "doubao-seedream-4-5-251128",
  "prompt": "Studio shot of a ceramic mug on a wooden table, warm natural light, ultra-detailed, 2k",
  "n": 2,
  "width": 1024,
  "height": 1024,
  "quality": "basic"
}

resp = requests.post(API_URL, json=payload, headers={
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
})
resp.raise_for_status()
data = resp.json()

# Example: each item has 'b64_json' or 'url' depending on provider
for i, item in enumerate(data.get("data", [])):
    img_b64 = item.get("b64_json")
    if img_b64:
        img_bytes = base64.b64decode(img_b64)
        with open(f"seedream_result_{i}.png", "wb") as f:
            f.write(img_bytes)
    else:
        print("Image URL:", item.get("url"))

Why this pattern? 聚合器通常返回 base64 负载或托管 URL;此代码可同时处理两者。端点通常会返回一个 task_id。轮询 GET /tasks/{task_id} 端点直至状态为 succeeded,再下载结果。许多提供方包含对此模式的内置 SDK 辅助。

How do I optimize image quality and keep text legible?

  1. 使用参考图以确保上下文与配色的一致性。
  2. 在提示词中明确指出版式需求(字体族、字重、对齐方式),并考虑在第二步将精确文字作为叠加层加入,以确保可读性。
  3. 采用两步流程:(a)生成基础构图;(b)针对局部(如标签区)的特写或文字区域进行二次渲染或编辑,以更高分辨率优化。

How should you write prompts for Seedream 4.5?

Prompt engineering principles

  • 明确具体:列出主体、动作、风格、镜头/相机、时间、期望的配色。
  • 使用身份锚点:若需在多图中保持相同面孔/道具,请加入持久描述(如“同一位留短卷发、穿绿色夹克、左眉有疤的女性”),并提供 1–3 张参考图。Seedream 4.5 的多参考融合已改进,但锚点更有帮助。
  • 负向提示:明确需要避免的内容(如“无文字”“无水印”“无多余肢体”)。
  • 短+长混合:先给出简洁的核心指令,再用几行细节与约束进行扩展。

Example prompt templates

产品主视觉(拟真)"A clean product hero shot of a matte black wireless speaker placed on a white tabletop, softbox lighting, 50mm, shallow depth of field, studio background, photoreal, no text"

奇幻插画(风格化)"Epic fantasy landscape, towering glass castle on a cliff, golden hour, volumetric fog, painterly, highly detailed, concept art"

图像编辑(移除对象)"Remove the person on the left and extend the background to fill the space, keep lighting consistent, no artifacts"

重文字样机"Mobile app landing screen mockup on an iPhone 14, with the text 'Launch Now' in Gotham Bold, make the button green and keep shadows soft"

角色肖像:"Heroic portrait of a female warrior, cinematic rim lighting, 85mm portrait lens, ultra-detailed skin texture, natural freckles, leather armor, neutral background, photorealistic."

Multi-image and reference prompts

在进行多图编辑时,明确指出每张参考图对应提示词的哪一部分。Seedream 4.5 在多参考场景下更擅长识别主要主体——但清晰指示(例如“face 使用 image_1,clothing texture 使用 image_2”)能带来更佳效果。

Output selection & postprocessing

  • 生成 N 个变体并运行客观筛选:人脸相似度评分、颜色直方图比较、版式 OCR 检查文字准确性。
  • 自动化 QC 阈值,将低于阈值的输出路由到人工修图。
  • 若需像素级精确文字,建议将最终版式交给排版工具处理——用模型生成背景与图像,再在后期合成精确文字。这样可降低对模型文字保真度的依赖,适配营销资产。

How do you perform image editing, inpainting, and multi-image composition?

Image editing workflow

  1. 将参考图上传至提供方或在请求中内联发送。
  2. 为 inpainting 提供遮罩(二值图),或提供边界标注以进行定点编辑。
  3. 提交编辑提示词,明确哪些区域需要更改、哪些区域保持不变。

许多 API 同时支持单图编辑与多图合成模式;4.5 明确针对主体身份保留与多图一致性进行了调优。

Example: Inpainting payload (JSON pseudocode)

{
  "model": "seedream-4.5",
  "mode": "image_edit",
  "image_url": "https://.../original.png",
  "mask_url": "https://.../mask.png",
  "prompt": "Replace background with a sunset beach — keep subject untouched, maintain original lighting on subject",
  "guidance": 9,
  "steps": 40
}

Tips for consistent multi-image editing

  • 为相关渲染使用相同的 seed,以保持跨帧一致性。
  • 在提示词中保持相机描述一致(例如“85mm 人像、柔光箱、3/4 构图”),以维持视角一致。
  • 编辑人脸时,提出更细粒度的保留条款(“保留面部结构,仅更改发色”),以减少身份漂移。

What are the best practices when using Seedream 4.5

How do you troubleshoot common issues?

以下是当结果偏差时的实用排查步骤:

Blurry faces / wrong details

提高面部细节提示的明确性(年龄、表情、光照),提供更高质量的参考图,或加入明确的“保留面部”指令,并降低编辑强度以保留更多原始信息。Seedream 4.5 改善了面部真实度,但输入仍然关键。

Text is unreadable or garbled

若需像素级精准的版式,请将矢量或栅格文字作为单独叠加层;否则使用更高分辨率设置,并加入明确的“render legible text: yes”风格指令。与前代相比,4.5 在密集文本上的处理有所提升,但排版完美度可能仍需后期合成。

Inconsistent batch lighting or composition

使用模板化提示词并固定光照/相机描述,或在单次批量调用中生成以提高一致性。BytePlus 与 CometAPI 为此提供了批量推理模式。

Final notes and next steps

Seedream 4.5 是一款成熟、面向生产的图像模型,针对真实创作工作流进行了明确的改进:更好的一致性、更佳的文字与面部渲染,以及多参考支持。当你需要快速试验与多模型灵活性时,可使用 CometAPI 或类似聚合器。

开发者可通过 CometAPI 访问 Seedream 4.5 API 等;最新模型版本 始终与官网保持同步。开始之前,请在 Playground 探索模型能力,并查阅 API 指南 获取详细说明。访问前,请确保你已登录 CometAPI 并获取 API Key。CometAPI 提供远低于官方价格的报价,助你更轻松集成。

Ready to Go?→ Seedream 4.5 免费试用

若想了解更多与 AI 相关的技巧、指南与资讯,请关注我们的 VKXDiscord

阅读更多

一个 API 中超 500 个模型

最高 20% 折扣