> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aioagi.tech/llms.txt
> Use this file to discover all available pages before exploring further.

# Seedream 系列介绍

> 了解 Seedream 系列在 AIOAGI 中的图像生成、图生图、多图融合和组图输出能力。

`Seedream` 系列是豆包图像生成与图像编辑模型系列。它适合文生图、图生图、多图融合、组图输出、视觉概念设计、商品图和营销素材生产。

AIOAGI 将 Seedream、Seedance、GPT-Image、GPT、Claude、DeepSeek、Gemini、Qwen 和 Vibe Coding 等模型聚合到统一平台。你可以使用 AIOAGI API Key，通过 OpenAI 兼容风格的 `POST /images/generations` 调用 Seedream 系列。模型名称、价格、尺寸范围、返回格式和支持策略可能变化，请以 **控制台** 和 **开发者指南** 为准。

<Warning>
  上线生产前，请先确认你的 API Key 所属 Token 组支持目标 Seedream 模型。不同 Token 组可用模型、额度、限流和计费方式可能不同。
</Warning>

## 系列定位

<CardGroup cols={2}>
  <Card title="Seedream 5.0" icon="wand-magic-sparkles">
    当前推荐优先评估的新一代图像模型。适合文生图、图生图、多图融合和高质量视觉创作。
  </Card>

  <Card title="Seedream 4.5 / 4.0" icon="image">
    适合稳定图像生成、图生图和组图输出。4.5 支持 `2K`、`4K` 或像素尺寸写法。
  </Card>

  <Card title="Seedream 3.0 t2i" icon="paintbrush">
    面向文生图任务。适合仍在使用旧提示词、需要 `seed` 和 `guidance_scale` 控制的场景。
  </Card>

  <Card title="Seededit 3.0 i2i" icon="pen-to-square">
    面向图片编辑。适合基于输入图像做局部改写、风格修改和元素替换。
  </Card>
</CardGroup>

## 当前参考模型

| 模型 ID                            | 主要能力              | 适用建议                     |
| -------------------------------- | ----------------- | ------------------------ |
| `doubao-seedream-5-0-260128`     | 文生图、图生图、多图融合、组图输出 | 新项目优先评估。                 |
| `doubao-seedream-4-5-251128`     | 文生图、图生图、多参考图、组图输出 | 已有 4.x 工作流可继续使用。         |
| `doubao-seedream-4-0-250828`     | 文生图、图生图、多图输入      | 适合兼容旧链路。                 |
| `doubao-seedream-3-0-t2i-250415` | 文生图               | 适合需要旧版参数控制的文生图任务。        |
| `doubao-seededit-3-0-i2i-250628` | 图片编辑              | 适合单图编辑和 `adaptive` 尺寸输出。 |

<Info>
  以上模型 ID 来自当前本地 Apifox 接口资料和官方文档链接。生产配置前，请在 **控制台**、`GET /models` 或 **开发者指南** 中重新确认。
</Info>

## 能力特点

* **统一图像接口**：Seedream 图像生成和编辑都通过 `POST /images/generations` 调用。
* **支持多种输入**：`image` 可以传入单张图片，也可以传入图片数组。图片支持 URL 或 `data:image/...;base64,...`。
* **支持组图输出**：`sequential_image_generation` 可设为 `auto`，由模型判断是否返回一组关联图片。
* **支持多图融合**：你可以传入多张参考图，让模型融合服装、主体、风格或场景。
* **支持灵活尺寸**：新模型可使用 `2K`、`3K`、`4K` 或具体像素尺寸。实际范围以控制台和开发者指南为准。
* **支持 URL 或 Base64 返回**：`response_format` 可使用 `url` 或 `b64_json`。URL 通常有有效期，请及时下载并转存。

## AIOAGI 使用方法

<Steps>
  <Step title="创建 API Key">
    登录 AIOAGI 控制台，在 **令牌** 或 **API Key** 页面创建密钥。建议为图像任务单独创建 Token 组，便于额度控制和账单追踪。
  </Step>

  <Step title="确认模型权限">
    在 **控制台**、**开发者指南** 或 `GET /models` 返回结果中确认目标 Seedream 模型可用。模型别名以控制台展示为准。
  </Step>

  <Step title="配置基础地址">
    在服务端保存 API Key 和 base URL。常用端点为 `https://api.aiearth.dev/v1`，也可以按网络情况使用 `https://api.aiearth.vip/v1`。
  </Step>

  <Step title="调用图像生成接口">
    使用 `POST /images/generations`。至少传入 `model` 和 `prompt`，再按任务需要传入 `image`、`size`、`response_format`、`watermark` 等参数。
  </Step>

  <Step title="保存结果和日志">
    保存返回的图片 URL 或 `b64_json`，并记录模型名、请求体、耗时、错误码和用量字段，便于排查和对账。
  </Step>
</Steps>

## API 调用

具体请求代码、参数表和返回说明请查看 [Seedream 系列 API](/api-reference/endpoint/seedream.mdx)。模型介绍页只保留能力、选型和使用流程说明。

## 核心参数

| 参数                                               | 类型                 | 说明                                                 |
| ------------------------------------------------ | ------------------ | -------------------------------------------------- |
| `model`                                          | `string`           | 必填。Seedream 模型 ID，例如 `doubao-seedream-5-0-260128`。 |
| `prompt`                                         | `string`           | 必填。用于生成或编辑图像的提示词，支持中文和英文。                          |
| `image`                                          | `string` 或 `array` | 可选。图生图、多图融合和多参考图任务使用。支持 URL 或 Base64。              |
| `size`                                           | `string`           | 可选。可使用 `2K`、`3K`、`4K` 或具体像素尺寸。不同模型支持范围不同。          |
| `response_format`                                | `string`           | 可选。`url` 或 `b64_json`。默认通常为 `url`。                 |
| `output_format`                                  | `string`           | 可选。Seedream 5.0 支持 `png` 或 `jpeg`。默认通常为 `jpeg`。    |
| `watermark`                                      | `boolean`          | 可选。是否添加水印。默认通常为 `true`。                            |
| `sequential_image_generation`                    | `string`           | 可选。`auto` 表示启用组图判断，`disabled` 表示只生成单张图。            |
| `sequential_image_generation_options.max_images` | `integer`          | 可选。组图输出最多图片数。当前资料中范围为 `1` 到 `15`。                  |
| `seed`                                           | `integer`          | 仅部分 3.0 模型支持。用于控制随机性。                              |
| `guidance_scale`                                 | `number`           | 仅部分 3.0 模型支持。用于控制提示词一致程度。                          |

## 尺寸建议

* Seedream 5.0 可用 `2K`、`3K` 或像素尺寸。像素尺寸和总像素范围请以控制台和开发者指南为准。
* Seedream 4.5 可用 `2K`、`4K` 或像素尺寸。适合高分辨率海报、商品图和组图。
* Seedream 4.0 可用 `1K`、`2K`、`4K` 或像素尺寸。适合兼容旧链路。
* Seedream 3.0 t2i 使用像素尺寸，例如 `1024x1024`、`1280x720`、`720x1280`。
* Seededit 3.0 i2i 当前资料中使用 `adaptive`，由输入图比例匹配输出尺寸。

## 排障建议

* 遇到 `401`，检查 API Key 和 `Authorization: Bearer sk-...` 请求头。
* 遇到 `403`，检查账户余额、Token 组额度和模型权限。
* 遇到 `404` 或 `model_not_found`，调用 `GET /models` 核对模型 ID。
* 遇到参数错误，先检查 `size`、`image`、`response_format`、`output_format` 是否被当前模型支持。
* 使用 `url` 返回格式时，请及时下载图片。URL 可能只在生成后一段时间内有效。

<Tip>
  如果你的业务已经使用 GPT-Image 系列，可以先保留原有链路，再用少量真实样例对比 Seedream 的主体一致性、图文融合、组图稳定性、耗时和成本。
</Tip>