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

# Seedream Overview

> Seedream image models, endpoints, and integration overview

## Introduction

Seedream is the ByteDance image model family for text-to-image, image editing, interactive editing, multi-reference fusion, and layer decomposition. These documents cover Seedream 5.5 Pro and Seedream 5.0 Pro, with separate scenario guides and copyable requests.

Call synchronously through the GravitexAI gateway:

* **Base URL**: `https://api.gravitex.ai`
* **Authorization**: `Bearer sk-xxxxxxxxxx`
* **Content-Type**: `application/json`

## Documented models

| Model | Model ID | Capabilities | Guides |
| - | - | - | - |
| Seedream 5.5 Pro | `dola-seedream-5-5-261028` | Generation, editing, interactive editing, multi-image fusion, native transparency, up to 99 layers, rich-text OCR | [Text to image](https://docs.gravitex.ai/en/api-reference/endpoint/seedream-5.5/generations.md) · [Image to image](https://docs.gravitex.ai/en/api-reference/endpoint/seedream-5.5/edits.md) |
| Seedream 5.0 Pro | `dola-seedream-5-0-pro-260628` | Generation, editing, interactive editing, multi-image fusion, transparent image editing, up to 16 layers | [Text to image](https://docs.gravitex.ai/en/api-reference/endpoint/seedream-5.0/generations.md) · [Image to image](https://docs.gravitex.ai/en/api-reference/endpoint/seedream-5.0/edits.md) |

> [!NOTE]
>
> Choose 5.5 Pro for text-only transparent output, output-count configuration, or rich-text OCR. 5.0 Pro transparent editing requires one alpha-channel reference; 5.5 Pro accepts up to 10 references without requiring alpha. Default output formats are `jpeg` for 5.0 Pro and `png` for 5.5 Pro. Check the model-specific defaults when switching.

## Find examples by scenario

| Goal | Guide | Key requirement |
| - | - | - |
| Generate from text | [5.5 Pro](https://docs.gravitex.ai/en/api-reference/endpoint/seedream-5.5/generations.md#text-to-image) · [5.0 Pro](https://docs.gravitex.ai/en/api-reference/endpoint/seedream-5.0/generations.md#text-to-image) | Omit `image` |
| Edit or blend references | [5.5 Pro](https://docs.gravitex.ai/en/api-reference/endpoint/seedream-5.5/edits.md#single-image-editing) · [5.0 Pro](https://docs.gravitex.ai/en/api-reference/endpoint/seedream-5.0/edits.md#single-image-editing) | Provide references and editing instructions |
| Generate transparent output from text | [5.5 Pro](https://docs.gravitex.ai/en/api-reference/endpoint/seedream-5.5/generations.md#transparent-text-to-image) | `background: "transparent"` + `output_format: "png"` |
| Separate layers | [5.5 Pro](https://docs.gravitex.ai/en/api-reference/endpoint/seedream-5.5/edits.md#automatic-layer-decomposition) · [5.0 Pro](https://docs.gravitex.ai/en/api-reference/endpoint/seedream-5.0/edits.md#layer-decomposition) | One input; omit `background` |
| Separate and recognize text/styles | [5.5 Pro](https://docs.gravitex.ai/en/api-reference/endpoint/seedream-5.5/edits.md#layer-decomposition-and-ocr) | `layer_decomposition_options.text_recognition: true` |
| Parameters and pricing | [5.5 Pro](https://docs.gravitex.ai/en/api-reference/endpoint/seedream-5.5.md) · [5.0 Pro](https://docs.gravitex.ai/en/api-reference/endpoint/seedream-5.0.md) | Check model-specific defaults, limits, and errors |

## Supported endpoints

| Method | Path | Use | Format |
| - | - | - | - |
| `POST` | `/v1/images/generations` | Text-to-image; also editing, fusion, or decomposition with `image` | JSON |
| `POST` | `/v1/images/edits` | Editing, fusion, or decomposition with the same request body | JSON |

> [!NOTE]
>
> Both routes forward to the same upstream endpoint. These guides use `/v1/images/generations` for both scenarios: omit `image` for text-to-image, or supply a URL/Base64 string or array for image-to-image. Ordinary generation supports at most 10 references; decomposition requires exactly one.

## Responses and pricing

Responses synchronously return `data` and `usage`. Default `response_format` is `url`: download `data[].url` within 24 hours. With `b64_json`, decode `data[].b64_json`. Ordinary generation returns one image. Decomposition returns a base image and layers with stacking order and bounding boxes; 5.5 Pro can also return rich-text OCR for regular printed text when `layer_decomposition_options.text_recognition` is enabled.

References and successful outputs are billed separately. Each output, including the base image and individual layers, uses its actual pixel tier. Reference, generation, and decomposition prices differ between models; see each model pricing guide.

> [card] [View current models and prices](https://maas.gravitex.ai/#/api-models)
>
> The model marketplace is authoritative for current availability, capabilities, and prices.

## Integration steps

1. Create an API Key and configure the gateway URL and Bearer authentication.
2. Choose a model and open its generation or editing guide.
3. Copy the full JSON body. Generation requires `model` and `prompt`; editing also requires `image`. For decomposition, use `layer_decomposition: true` with one image; `prompt` is optional.
4. Send a synchronous request, save the URL result or decode Base64, and inspect `usage`. Reconstruct layers using `z_index` and `bounding_box`.


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