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

# Seedream 系列

> 字节跳动豆包图像生成 — 文生图 / 图像编辑 / 组图生成

字节跳动 Seed 团队的图像生成模型系列。**当前提供 `doubao-seedream-5.0-lite` 版本**(4.0 / 4.5 因按 token 计费暂未接入)。

**5.0 Lite** — 视觉推理(CoT)+ 实时联网搜索,强身份保留(眼/下颌/比例/肤色跨风格不变),支持 1K/2K/4K 输出,性价比线。

按张计费。

## 定价

| 模型                         | 单价(每张)    |
| -------------------------- | --------- |
| `doubao-seedream-5.0-lite` | `$0.0315` |

## 模式速查

| 模式                    | 触发字段                                  | action     |
| --------------------- | ------------------------------------- | ---------- |
| **文生图**               | 仅 `prompt`                            | `generate` |
| **图像编辑(局部重绘 / 光影修改)** | `+ image_urls` + `action: "edit"`     | `edit`     |
| **组图生成(主题相关一组)**      | `sequential_image_generation: "auto"` | `generate` |

## 调用示例

<CodeGroup>
  ```bash 文生图(最简) theme={"system"}
  curl -X POST https://www.qingbo.dev/v1/tasks \
    -H "Authorization: Bearer $WAVE_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "model": "doubao-seedream-5.0-lite",
      "prompt": "未来主义城市夜景,霓虹灯映在湿润街面,电影感构图",
      "resolution": "2K",
      "aspect_ratio": "16:9"
    }'
  ```

  ```bash 图像编辑(edit) theme={"system"}
  curl -X POST https://www.qingbo.dev/v1/tasks \
    -H "Authorization: Bearer $WAVE_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "model": "doubao-seedream-5.0-lite",
      "action": "edit",
      "prompt": "把背景换成黄昏天空,人物保持不变",
      "image_urls": ["https://cdn.example.com/portrait.jpg"],
      "resolution": "2K"
    }'
  ```

  ```bash 多图参考(edit + 多张) theme={"system"}
  curl -X POST https://www.qingbo.dev/v1/tasks \
    -H "Authorization: Bearer $WAVE_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "model": "doubao-seedream-5.0-lite",
      "action": "edit",
      "prompt": "把第一张图的角色放进第二张图的场景里",
      "image_urls": [
        "https://cdn.example.com/character.jpg",
        "https://cdn.example.com/scene.jpg"
      ],
      "resolution": "4K",
      "aspect_ratio": "16:9"
    }'
  ```

  ```bash 组图生成(主题相关 1 组) theme={"system"}
  curl -X POST https://www.qingbo.dev/v1/tasks \
    -H "Authorization: Bearer $WAVE_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "model": "doubao-seedream-5.0-lite",
      "prompt": "电商主图四张:正面 / 侧面 / 细节 / 场景应用",
      "sequential_image_generation": "auto",
      "sequential_image_generation_options": {"max_images": 4},
      "resolution": "4K",
      "aspect_ratio": "1:1"
    }'
  ```
</CodeGroup>

<ResponseExample>
  ```json 提交成功 theme={"system"}
  {
    "task_id": "task-wave1775285160b950328499",
    "model": "doubao-seedream-5.0-lite",
    "action": "generate",
    "status": "queued",
    "created_at": 1775285160040,
    "progress": 0
  }
  ```
</ResponseExample>

提交后用 [`GET /v1/tasks/{task_id}`](/cn/api-reference/task/status) 轮询状态,详见 [任务系统](/cn/docs/task-system)。

## 可用模型

| 模型 ID                      | 说明                                             |
| -------------------------- | ---------------------------------------------- |
| `doubao-seedream-5.0-lite` | 视觉推理 + 联网搜索,身份保留强,支持 1K/2K/4K,文生 / 编辑 / 组图统一接口 |

## 通用参数

<ParamField body="model" type="string" required>
  目前为 `doubao-seedream-5.0-lite`
</ParamField>

<ParamField body="action" type="string" default="generate">
  操作类型,可选值:

  * `generate` — 文生图(默认)
  * `edit` — 图像编辑 / 多图参考(需配合 `image_urls`)
</ParamField>

<ParamField body="prompt" type="string" required>
  图像描述文本,支持中英文
</ParamField>

<ParamField body="n" type="integer" default="1">
  生成数量(单次返回多张)
</ParamField>

<ParamField body="aspect_ratio" type="string" default="1:1">
  画面宽高比,共 9 种:

  * `1:1` — 正方形
  * `4:3` / `3:4` — 横/竖版标准
  * `16:9` / `9:16` — 横/竖版宽屏
  * `3:2` / `2:3` — 横/竖版相机比
  * `21:9` / `9:21` — 超宽屏 / 超长竖图
</ParamField>

<ParamField body="resolution" type="string" default="2K">
  输出分辨率,可选 `1K` / `2K` / `4K`
</ParamField>

<ParamField body="image_urls" type="string[]">
  参考图片 URL 数组,`action: "edit"` 时使用
</ParamField>

<ParamField body="callback_url" type="string">
  Webhook 回调地址,任务终态时调用。详见 [回调机制](/cn/docs/sync-async#异步任务-webhook)
</ParamField>

<ParamField body="callback_events" type="string[]">
  订阅的回调事件类型,详见 [回调机制](/cn/docs/sync-async#异步任务-webhook)
</ParamField>

## 模型特定参数

<ParamField body="watermark" type="boolean" default="false">
  是否加 AI 生成水印
</ParamField>

<ParamField body="optimize_prompt_options" type="string" default="standard">
  提示词优化模式,可选值:

  * `standard` — 标准优化(默认)
  * `fast` — 快速模式
</ParamField>

<ParamField body="sequential_image_generation" type="string" default="disabled">
  组图生成模式,可选值:

  * `disabled` — 单图(默认)
  * `auto` — 自动组图(主题相关多张)
</ParamField>

<ParamField body="sequential_image_generation_options" type="object">
  组图选项,如 `{"max_images": 4}`
</ParamField>

## 资源限制

| 项目     | 限制                     |
| ------ | ---------------------- |
| 单张图片大小 | ≤ 30MB,支持 JPG/PNG/WEBP |
| 输出分辨率  | `1K` / `2K` / `4K`     |
| 输出文件   | 图片链接,24 小时有效           |

## 相关文档

* [任务系统详解](/cn/docs/task-system) — 任务状态机 / 轮询节奏 / 异步推送
* [请求响应格式](/cn/docs/request-response) — 通用错误码 / Headers / 限流
* [认证](/cn/docs/authentication) — API Key 申请与使用