> ## 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 5.5 Pro · 매개변수 및 요금

> Seedream 5.5 Pro 인증, 공통 매개변수, 응답 필드, 요금 및 오류

## 소개

공통 모델 참조 문서입니다. 복사 가능한 요청은 사용 사례별 문서에서 확인하세요: [텍스트-이미지](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)

## 인증

**Authorization** `string` *required*

Bearer sk-xxxxxxxxxx

**Content-Type** `string` *required*

application/json

플랫폼의 API 키 페이지에서 키를 생성하세요. 프런트엔드 코드, 공개 저장소 또는 클라이언트 패키지에 키를 포함하지 마세요.

## 모델 정보

| 항목 | 설명 |
| - | - |
| 모델 ID | `dola-seedream-5-5-261028` |
| 텍스트-이미지 | 지원 |
| 단일 이미지 편집 | 지원 |
| 다중 이미지 참조 / 융합 | 참조 이미지 최대 10장 |
| 대화형 편집 | 좌표, 영역 지정, 화살표, 스케치 |
| 투명 이미지 (RGBA) | 텍스트-이미지와 이미지-이미지 |
| 레이어 분해 | 기본 이미지 1장 + 레이어 최대 99개 |
| 서식 있는 텍스트 OCR | 레이어 분해 시에만 지원 |
| 프롬프트 최적화 | `standard` |
| 프롬프트 언어 | 중국어, 영어, 러시아어, 아랍어, 필리핀어, 태국어, 튀르키예어, 한국어, 말레이어, 스페인어, 포르투갈어, 인도네시아어, 프랑스어, 독일어, 베트남어, 일본어 |
| 연속 이미지 생성 / 웹 검색 / 스트리밍 | 지원하지 않음 |
| 요청당 출력 수 | 레이어 분해를 제외하면 1장 |
| 응답 방식 | 동기식 |

## 엔드포인트

```http theme={null}
POST https://api.gravitex.ai/v1/images/generations
```

`POST https://api.gravitex.ai/v1/images/edits`도 같은 JSON 요청 본문을 받습니다. 두 경로는 동일한 업스트림 이미지 엔드포인트로 전달됩니다.

## 요청 매개변수

| 매개변수 | 유형 | 필수 | 기본값 | 설명 |
| - | - | - | - | - |
| `model` | string | 예 | - | `dola-seedream-5-5-261028` |
| `prompt` | string | 생성/편집: 필수, 분해: 선택 | - | 생성 또는 편집 지시문. 레이어 분해 시 분리할 요소를 지정합니다 |
| `image` | string / string\[] | 편집과 분해 시 필수 | - | 참조 URL 또는 Base64. 텍스트-이미지에서는 생략합니다 |
| `size` | string | 아니요 | 생성/편집: `2K`, 분해: `auto` | [해상도 단계 또는 사용자 지정 크기](https://docs.gravitex.ai/ko/api-reference/endpoint/seedream-5.5.md#size) |
| `optimize_prompt_options` | object | 아니요 | `{"mode":"standard"}` | `standard`만 지원합니다 |
| `output_format` | string | 아니요 | `png` | `jpeg` / `png`. 분해 시 기본 이미지에만 적용되며 레이어는 항상 PNG입니다. |
| `background` | string | 아니요 | `auto` | `auto` / `transparent` / `opaque` |
| `response_format` | string | 아니요 | `url` | `url`(24시간 유효) 또는 `b64_json` |
| `watermark` | boolean | 아니요 | `true` | 오른쪽 아래에 AI 생성 워터마크를 추가합니다 |
| `layer_decomposition` | boolean | 아니요 | `false` | [레이어 분해 활성화](https://docs.gravitex.ai/ko/api-reference/endpoint/seedream-5.5/edits.md#layer_decomposition) |
| `layer_decomposition_options` | object | 아니요 | - | [레이어 분해를 활성화했을 때만 적용되는 설정](https://docs.gravitex.ai/ko/api-reference/endpoint/seedream-5.5/edits.md#layer_decomposition_options) |
| `safety_identifier` | string | 아니요 | - | 최종 사용자의 고정된 고유 식별자. 영문 문자열로 최대 64자입니다. 개인정보 보호를 위해 사용자 이름, ID 또는 이메일의 해시를 권장하며 요청에 있으면 그대로 반환합니다. |
| `n` | integer | 아니요 | `1` | 호환 필드. 일반 생성에서는 생략하거나 `1`을 사용하세요. 레이어 분해 수량은 별도 제한을 따릅니다. |

> [!WARNING]
>
> `quality`, `sequential_image_generation`, `sequential_image_generation_options`, `stream`, `tools`는 전달하지 마세요. 이 모델들은 연속 이미지 생성, 스트리밍, 웹 검색을 지원하지 않습니다. 해상도는 `size`로 설정하세요.

### prompt

생성과 편집에서는 필수이며 분해에서는 선택 사항입니다. 중국어는 300자 이내, 영어는 600단어 이내를 권장합니다. 대화형 편집: [이미지-이미지](https://docs.gravitex.ai/ko/api-reference/endpoint/seedream-5.5/edits.md#prompt)

### image

[참조 이미지 형식과 제한](https://docs.gravitex.ai/ko/api-reference/endpoint/seedream-5.5/edits.md#image)

### size

이미지 생성과 일반 편집에서는 다음 형식 중 하나를 사용하세요:

* 해상도 단계: `1K`, `1.5K`, `2K`(기본값). 프롬프트에 원하는 화면 비율이나 용도를 설명하세요.
* 사용자 지정 `WIDTHxHEIGHT`: 소문자 `x`를 사용하세요. 총 픽셀 수는 `[921600, 4624220]`, 가로/세로 비율은 `[1/16, 16]`이어야 합니다.

| 예시 | 유효 여부 | 이유 |
| - | - | - |
| `2880x1440` | 예 | 4,147,200픽셀, 비율 2 |
| `1024x1024` | 예 | 1,048,576픽셀 |
| `512x512` | 아니요 | 262,144픽셀로 최솟값 921,600 미만 |

레이어 분해는 `1K`, `1.5K`, `2K`, `auto`(기본값)만 지원하며 사용자 지정 픽셀 크기는 지원하지 않습니다. 기본 이미지는 `size`와 원본 비율을 따르고 각 레이어는 선택한 해상도 단계에 가까운 크기로 자체 비율을 유지합니다. `auto`는 원본 크기를 사용하되 비율을 유지하면서 1K–2K 범위로 조정합니다.

단계별 일반적인 크기(예시에 한정되지 않음):

| 화면 비율 | 1K | 1.5K | 2K |
| - | - | - | - |
| 1:1 | 1024x1024 | 1536x1536 | 2048x2048 |
| 4:3 | 1152x864 | 1792x1344 | 2368x1776 |
| 3:4 | 864x1152 | 1344x1792 | 1776x2368 |
| 16:9 | 1424x800 | 2048x1152 | 2816x1584 |
| 9:16 | 800x1424 | 1152x2048 | 1584x2816 |
| 3:2 | 1248x832 | 1872x1248 | 2496x1664 |
| 2:3 | 832x1248 | 1248x1872 | 1664x2496 |
| 21:9 | 1568x672 | 2352x1008 | 3136x1344 |

### optimize\_prompt\_options

`{"optimize_prompt_options":{"mode":"standard"}}`를 사용하세요.

### background

[사용 조건 및 예제](https://docs.gravitex.ai/ko/api-reference/endpoint/seedream-5.5/generations.md#background)

### layer\_decomposition

[사용 조건 및 예제](https://docs.gravitex.ai/ko/api-reference/endpoint/seedream-5.5/edits.md#layer_decomposition)

### layer\_decomposition\_options

[사용 조건 및 예제](https://docs.gravitex.ai/ko/api-reference/endpoint/seedream-5.5/edits.md#layer_decomposition_options)

### safety\_identifier

최대 64자의 고정된 고유 영문 문자열을 사용하세요. 사용자 ID나 이메일의 해시를 권장하며 요청에 포함하면 응답에 그대로 반환됩니다.

## 성공 응답

일반 생성은 이미지 1장을 반환합니다. 입력 이미지 사용량은 실제 입력 수를 반영합니다. 아래 URL은 응답 구조 예시입니다.

```json theme={null}
{
  "model": "dola-seedream-5-5-261028",
  "created": 1784868948,
  "data": [
    {
      "url": "https://example.com/generated-image.png",
      "size": "2048x2048",
      "output_format": "png",
      "background": "opaque"
    }
  ],
  "usage": {
    "input_images": 0,
    "generated_images": 1,
    "output_tokens": 16384,
    "total_tokens": 16384
  }
}
```

### 응답 필드

| 필드 | 유형 | 설명 |
| - | - | - |
| `model` | string | 실제 모델 ID |
| `created` | integer | Unix 타임스탬프(초) |
| `data` | array | 일반 생성은 이미지 1장, 분해는 기본 이미지와 레이어 목록 |
| `data[].url` | string | 이미지 URL. 24시간 유효하며 `response_format: "url"`일 때 반환 |
| `data[].b64_json` | string | `response_format: "b64_json"`일 때 반환되는 Base64 이미지 데이터 |
| `data[].size` | string | 실제 픽셀 크기(예: `2048x2048`) |
| `data[].output_format` | string | 실제 형식 `jpeg` / `png`. 레이어는 항상 PNG |
| `data[].background` | string | 실제 투명도: `transparent` 또는 `opaque` |
| `safety_identifier` | string | 요청에 포함한 경우 그대로 반환 |
| `usage.input_images` | integer | 입력 참조 이미지 수 |
| `usage.generated_images` | integer | 과금 기준이 되는 성공 출력 수. 기본 이미지와 모든 레이어 포함 |
| `usage.output_tokens` | integer | 출력 토큰: `sum(width × height) / 256`의 정수값 |
| `usage.total_tokens` | integer | 현재 입력 토큰은 계산하지 않으며 출력 토큰과 동일 |
| `error.code` / `error.message` | string | 이미지가 생성되지 않았을 때 반환 |

[추가 레이어/OCR 필드 및 레이어 복원](https://docs.gravitex.ai/ko/api-reference/endpoint/seedream-5.5/edits.md#응답-필드)

URL 결과는 24시간 이내에 다운로드하여 저장하세요.

## 요금

**계산식**: 참조 이미지 요금 + 각 출력 이미지의 실제 픽셀 구간별 요금 합계.

| 항목 | 구간 | 미국 달러 / 장 |
| - | - | - |
| 참조 이미지 | 첫 번째를 포함한 모든 이미지 | 0.008 |
| 이미지 생성 출력 | 총 픽셀 ≤ 261만 | 0.020 |
| 이미지 생성 출력 | 총 픽셀 > 261만 | 0.035 |
| 레이어 분해 출력 | 총 픽셀 ≤ 261만 | 0.020 |
| 레이어 분해 출력 | 총 픽셀 > 261만 | 0.035 |

* 공식 기본 가격이며 실제 요금에는 토큰 그룹 배율이 적용됩니다. 모델 광장의 가격을 확인하세요.
* 성공적으로 생성된 이미지만 과금합니다. 검토 거부 등으로 출력되지 않은 이미지는 과금하지 않습니다.
* 기본 이미지와 각 레이어는 별도 출력 이미지이며 각각 실제 픽셀 수로 요금 구간을 정합니다.

5.0 Pro와 달리 분해 출력에 할인이 적용되지 않습니다. `max_images` 상한은 100장입니다. 비용에 맞게 적절한 제한을 설정하세요.

**예시**:

* 참조 2장 + 2048×2048 출력 1장: `2 × 0.008 + 0.035 = 0.051 USD`.
* 참조 1장 + 2048×2048 기본 이미지 1장 + 1K 이하 레이어 6개: `0.008 + 0.035 + 6 × 0.020 = 0.163 USD`.

## 오류 처리

요청 실패 시 JSON 오류 객체가 반환됩니다:

```json theme={null}
{
  "error": {
    "message": "오류 설명",
    "type": "invalid_request_error",
    "code": "InvalidParameter"
  }
}
```

| 문제 | 조치 |
| - | - |
| 잘못된 API 키 | `Authorization: Bearer ...`를 확인하세요 |
| 프롬프트 누락 | 생성과 편집에는 비어 있지 않은 `prompt`가 필요합니다 |
| 참조 이미지를 읽을 수 없음 | 공개 URL 접근 가능 여부와 만료 여부 또는 `data:image/<format>;base64,` 접두사를 확인하세요 |
| 지원하지 않는 크기 | `1K` / `1.5K` / `2K` 또는 총 픽셀 921600–4624220 범위의 사용자 지정 크기를 사용하세요 |
| 레이어 분해 오류 | 총 픽셀 수가 512×512 이상인 PNG/JPEG 이미지 1장을 사용하고 `background`는 생략하세요 |
| 투명 이미지 오류 | PNG로 출력하세요. 5.0 Pro는 알파 채널이 있는 참조 이미지 1장이 추가로 필요합니다 |
| 지원하지 않는 매개변수 | 위에서 지원하지 않는 것으로 안내한 필드를 제거하세요 |
| 여러 일반 이미지 출력 | 요청을 각각 보내세요 |
| 결과 URL 만료 | 결과를 즉시 다운로드하여 저장하세요 |
| `max_images` | `[2, 100]` 범위의 값을 사용하세요 |
| `optimize_prompt_options.mode` | `standard`만 지원합니다 |


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