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

> ## Agent Instructions
> Send API requests to https://api.ttapi.io with the TT-API-KEY header. Midjourney account hosting uses https://hold.ttapi.io. Claude Code uses https://cc.ttapi.io.
> Most generation endpoints are asynchronous. The submit response returns a job id. Poll that product's fetch endpoint, or pass a webhook on the submit request. A fetch call does not start a new generation.
> 1 USD = 100 quota. Check the pricing page for that product before estimating cost.
> This file lists the English docs. Follow every /_llms/ link recursively for the API reference, Chinese, and Russian. Open a page's .md URL for the endpoint schema.

# Seedream 图片生成 API 文档

> 查看 Seedream 图片生成 API 文档，支持文生图、图生图、多图融合、图层拆分、交互编辑等能力，提供异步与同步两套接口。

# Seedream 图片生成 API

这里是 **Seedream 图片生成 API** 总览页，你可以在这里快速了解 Seedream 提供的图片生成能力，并进入具体接口文档。

## Seedream 图片生成 API 可以做什么

Seedream 提供多种图片生成能力，满足不同场景需求：

* **文生图**：通过文本提示词直接生成高质量图片
* **图生图**：基于参考图片进行风格转换或内容编辑
* **多图融合**：基于多张参考图融合生成新图片
* **图层拆分**：将单张图片拆解为底图和多个图层（5.0 系列）
* **交互编辑**：通过坐标、框选、箭头等方式精准编辑图片（5.0 系列）

## 支持模型

| 模型 | 说明 |
| :- | :- |
| `doubao-seedream-5-0-pro-260628` | 专业版，支持图层拆分、交互编辑、文生图、图生图、多图融合 |
| `doubao-seedream-5-0-flash-260915` | 快速版，支持图层拆分、交互编辑、文生图、图生图、多图融合 |

## 异步接口（推荐）

提交任务后返回 `id`，通过查询接口获取结果。适合生产环境集成，支持 webhook 回调通知。

| 使用场景 | 接口 | 说明 |
| :- | :- | :- |
| 文生图 | [文生图 API](/api/cn/seedream/text-to-image.md) | 仅通过文本提示词生成图片 |
| 图生图 | [图生图 API](/api/cn/seedream/image-to-image.md) | 基于单张参考图片生成图片 |
| 多图融合 | [多图融合 API](/api/cn/seedream/multi-image.md) | 基于多张参考图融合生成图片 |
| 图层拆分 | [图层拆分 API](/api/cn/seedream/layer-decomposition.md) | 将图片拆解为底图和多个图层 |
| 交互编辑 | [交互编辑 API](/api/cn/seedream/interactive-edit.md) | 通过坐标等方式精准编辑图片 |
| 查询结果 | [Fetch API](/api/cn/seedream/fetch.md) | 查询异步任务状态和结果 |

## 同步接口

请求后直接返回生成结果，无需额外查询。同步接口与异步接口使用相同的场景分类（文生图、图生图、多图融合、图层拆分、交互编辑），仅参数结构和返回格式不同。详见 [文生图（同步）API](/api/cn/seedream/text-to-image-sync.md)。

## 推荐接入流程

### 异步接口（推荐）

1. 根据场景选择合适的异步接口
2. 调用接口提交任务，获取 `id`
3. 使用 [Fetch API](/api/cn/seedream/fetch.md) 轮询查询任务状态
4. 当 `status` 为 `SUCCESS` 时，从返回结果中获取图片 URL

### 同步接口

1. 调用 [文生图（同步）API](/api/cn/seedream/text-to-image-sync.md) 查看各场景参数差异
2. 根据场景构造请求参数，调用 `POST /sd/api/v3/images/generations`
3. 直接从响应中获取生成的图片 URL（无需额外查询）

### 异步任务状态说明

* `PENDING_QUEUE`：任务待排队
* `ON_QUEUE`：任务排队中
* `SUCCESS`：任务执行成功
* `FAILED`：任务执行失败

## 为什么用 Seedream 图片生成 API

* **高质量输出**：支持多种分辨率档位（1K / 1.5K / 2K），画面细腻清晰
* **多种生成模式**：支持文生图、图生图、多图融合、图层拆分、交互编辑等多种能力
* **灵活调用方式**：提供异步（推荐）和同步两套接口，满足不同业务场景
* **灵活控制**：支持透明背景、自定义尺寸、多种输出格式等参数
* **统一网关**：使用 TTAPI 统一的 API 网关和鉴权机制


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.