> ## 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 개요

> Seedream 이미지 모델, 엔드포인트 및 연동 안내

## 소개

Seedream은 텍스트-이미지, 이미지 편집, 대화형 편집, 다중 참조 융합 및 레이어 분해를 위한 ByteDance 이미지 모델 시리즈입니다. 이 문서는 Seedream 5.5 Pro와 Seedream 5.0 Pro를 다루며 사용 사례별 안내와 복사 가능한 요청을 제공합니다.

GravitexAI 게이트웨이를 통해 동기식으로 호출합니다:

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

## 문서에서 지원하는 모델

| 모델 | 모델 ID | 기능 | 문서 |
| - | - | - | - |
| Seedream 5.5 Pro | `dola-seedream-5-5-261028` | 생성, 편집, 대화형 편집, 다중 이미지 융합, 네이티브 투명 이미지, 최대 99개 레이어, 서식 있는 텍스트 OCR | [텍스트-이미지](https://docs.gravitex.ai/ko/api-reference/endpoint/seedream-5.5/generations.md) · [이미지-이미지](https://docs.gravitex.ai/ko/api-reference/endpoint/seedream-5.5/edits.md) |
| Seedream 5.0 Pro | `dola-seedream-5-0-pro-260628` | 생성, 편집, 대화형 편집, 다중 이미지 융합, 투명 이미지 편집, 최대 16개 레이어 | [텍스트-이미지](https://docs.gravitex.ai/ko/api-reference/endpoint/seedream-5.0/generations.md) · [이미지-이미지](https://docs.gravitex.ai/ko/api-reference/endpoint/seedream-5.0/edits.md) |

> [!NOTE]
>
> 텍스트만으로 투명 이미지를 생성하거나 출력 수 설정 또는 서식 있는 텍스트 OCR이 필요하면 5.5 Pro를 선택하세요. 5.0 Pro의 투명 편집은 알파 채널 참조 1장이 필요하지만 5.5 Pro는 알파 채널 없이 최대 10장까지 받습니다. 기본 출력 형식은 5.0 Pro는 `jpeg`, 5.5 Pro는 `png`입니다. 모델 변경 시 해당 기본값을 확인하세요.

## 사용 사례별 예제

| 목적 | 문서 | 핵심 조건 |
| - | - | - |
| 텍스트로 이미지 생성 | [5.5 Pro](https://docs.gravitex.ai/ko/api-reference/endpoint/seedream-5.5/generations.md#텍스트-이미지) · [5.0 Pro](https://docs.gravitex.ai/ko/api-reference/endpoint/seedream-5.0/generations.md#텍스트-이미지) | `image` 생략 |
| 참조 이미지 편집 또는 융합 | [5.5 Pro](https://docs.gravitex.ai/ko/api-reference/endpoint/seedream-5.5/edits.md#단일-이미지-편집) · [5.0 Pro](https://docs.gravitex.ai/ko/api-reference/endpoint/seedream-5.0/edits.md#단일-이미지-편집) | 참조 이미지와 편집 지시문 전달 |
| 텍스트로 투명 이미지 생성 | [5.5 Pro](https://docs.gravitex.ai/ko/api-reference/endpoint/seedream-5.5/generations.md#텍스트로-투명-이미지-생성) | `background: "transparent"` + `output_format: "png"` |
| 레이어 분해 | [5.5 Pro](https://docs.gravitex.ai/ko/api-reference/endpoint/seedream-5.5/edits.md#자동-레이어-분해) · [5.0 Pro](https://docs.gravitex.ai/ko/api-reference/endpoint/seedream-5.0/edits.md#레이어-분해) | 입력 1장, `background` 생략 |
| 텍스트/스타일 분해 및 인식 | [5.5 Pro](https://docs.gravitex.ai/ko/api-reference/endpoint/seedream-5.5/edits.md#레이어-분해-및-ocr) | `layer_decomposition_options.text_recognition: true` |
| 매개변수 및 요금 | [5.5 Pro](https://docs.gravitex.ai/ko/api-reference/endpoint/seedream-5.5.md) · [5.0 Pro](https://docs.gravitex.ai/ko/api-reference/endpoint/seedream-5.0.md) | 모델별 기본값, 제한 및 오류 확인 |

## 지원 엔드포인트

| 메서드 | 경로 | 용도 | 형식 |
| - | - | - | - |
| `POST` | `/v1/images/generations` | 텍스트-이미지. `image`로 편집, 융합 또는 분해도 가능 | JSON |
| `POST` | `/v1/images/edits` | 동일한 요청 본문으로 편집, 융합 또는 분해 | JSON |

> [!NOTE]
>
> 두 경로는 같은 업스트림 엔드포인트로 전달됩니다. 이 문서는 두 사례 모두 `/v1/images/generations`를 사용합니다. 텍스트-이미지에서는 `image`를 생략하고 이미지-이미지에서는 URL/Base64 문자열 또는 배열을 전달하세요. 일반 생성은 참조 최대 10장, 분해는 정확히 1장입니다.

## 응답 및 요금

응답은 `data`와 `usage`를 동기식으로 반환합니다. `response_format` 기본값은 `url`이며 `data[].url`을 24시간 이내에 다운로드하세요. `b64_json`이면 `data[].b64_json`을 디코딩합니다. 일반 생성은 이미지 1장을 반환합니다. 분해는 쌓임 순서와 경계 상자 정보가 있는 기본 이미지와 레이어를 반환하며 5.5 Pro는 `layer_decomposition_options.text_recognition`을 활성화하면 정형 인쇄 텍스트의 서식 있는 텍스트 OCR도 반환할 수 있습니다.

참조 이미지와 성공 출력은 별도로 과금합니다. 기본 이미지와 개별 레이어를 포함한 각 출력은 실제 픽셀 구간을 적용합니다. 참조, 생성 및 분해 가격은 모델마다 다르므로 각 모델의 요금 안내를 확인하세요.

> [card] [최신 모델 및 가격 보기](https://maas.gravitex.ai/#/api-models)
>
> 최신 모델 제공 여부, 기능 및 가격은 모델 광장을 기준으로 합니다.

## 연동 순서

1. API 키를 생성하고 게이트웨이 URL과 Bearer 인증을 설정하세요.
2. 모델을 선택하고 생성 또는 편집 문서를 여세요.
3. 전체 JSON 본문을 복사하세요. 생성에는 `model`과 `prompt`, 편집에는 추가로 `image`가 필요합니다. 분해는 이미지 1장과 `layer_decomposition: true`를 사용하며 `prompt`는 선택 사항입니다.
4. 동기 요청을 보내고 URL 결과를 저장하거나 Base64를 디코딩한 뒤 `usage`를 확인하세요. `z_index`와 `bounding_box`로 레이어를 복원하세요.


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