> ## 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 텍스트-이미지 매개변수, 제한 및 복사 가능한 예제

## 소개

프롬프트로 이미지 1장을 생성하며 `image`는 생략합니다. 네이티브 투명 이미지 출력을 지원합니다. [참조 기반 편집, 융합 및 분해는 이미지-이미지 문서를 확인하세요.](https://docs.gravitex.ai/ko/api-reference/endpoint/seedream-5.5/edits.md)

## 엔드포인트 및 인증

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

`Authorization: Bearer sk-xxxxxxxxxx`와 `Content-Type: application/json`을 사용하세요. [매개변수 및 요금](https://docs.gravitex.ai/ko/api-reference/endpoint/seedream-5.5.md#인증)

## 요청 매개변수

| 매개변수 | 유형 | 필수 | 설명 |
| - | - | - | - |
| `model` | string | 예 | `dola-seedream-5-5-261028` |
| `prompt` | string | 예 | 생성할 이미지를 설명하세요. 중국어 300자, 영어 600단어 이내를 권장합니다 |
| `size` | string | 아니요 | 기본값 `2K`. `1K`, `1.5K`, `2K` 또는 사용자 지정 `WIDTHxHEIGHT` |
| `output_format` | string | 아니요 | 기본값: `png`. `jpeg` / `png`. 투명 출력에는 PNG를 사용하세요. |
| `response_format` | string | 아니요 | 기본값: `url`. `url`(24시간 유효) 또는 `b64_json` |
| `watermark` | boolean | 아니요 | 기본값: `true`. 오른쪽 아래에 AI 생성 워터마크를 추가합니다 |
| `background` | string | 아니요 | 기본값: `auto`. `auto` / `transparent` / `opaque` |
| `optimize_prompt_options` | object | 아니요 | 기본값: `{"mode":"standard"}`. `standard`만 지원합니다 |

일반 생성에서 `n`은 생략하거나 `1`을 사용하고, 결과가 여러 장 필요하면 요청을 각각 보내세요. [공통 매개변수](https://docs.gravitex.ai/ko/api-reference/endpoint/seedream-5.5.md#요청-매개변수)에서 전체 기본값과 `safety_identifier`를 확인하세요. 두 모델 모두 `quality`, 연속 이미지 생성, 스트리밍 및 웹 검색을 지원하지 않습니다.

### size

[전체 크기 규칙과 해상도 표](https://docs.gravitex.ai/ko/api-reference/endpoint/seedream-5.5.md#size)

기본값은 `2K`입니다. `1K`, `1.5K`, `2K` 또는 사용자 지정 `WIDTHxHEIGHT`를 사용하세요. 사용자 지정 총 픽셀 수는 `[921600, 4624220]`, 화면 비율은 `[1/16, 16]`이어야 합니다. `1024x1024`는 유효하지만 `512x512`는 유효하지 않습니다.

### background

| 값 | 설명 |
| - | - |
| `auto` | 기본값. 프롬프트와 출력 형식에 따라 모델이 결정합니다. JPEG에는 알파 채널이 없습니다. |
| `opaque` | 알파 채널 없는 RGB 출력 |
| `transparent` | 알파 채널이 있는 RGBA 출력. PNG를 사용하세요 |

> [!NOTE]
>
> 텍스트-이미지는 참조 이미지 없이 네이티브 투명 이미지 생성을 지원합니다. 실제 투명도는 요청값과 다를 수 있으므로 `data[].background`를 확인하세요.

> [!WARNING]
>
> `background: "transparent"`와 JPEG 출력을 함께 사용하지 마세요.

## 호출 예제

각 예제는 전체 JSON 본문과 동일한 cURL을 제공합니다. `sk-xxxxxxxxxx`를 자신의 API 키로 바꾸세요.

### 텍스트-이미지

```json 요청 본문 theme={null}
{
  "model": "dola-seedream-5-5-261028",
  "prompt": "미래 도시의 야경, 영화 포스터 스타일, 16:9 가로형",
  "size": "2K",
  "output_format": "jpeg",
  "watermark": false
}
```

```bash cURL theme={null}
curl --location 'https://api.gravitex.ai/v1/images/generations' \
  --header 'Authorization: Bearer sk-xxxxxxxxxx' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "dola-seedream-5-5-261028",
    "prompt": "미래 도시의 야경, 영화 포스터 스타일, 16:9 가로형",
    "size": "2K",
    "output_format": "jpeg",
    "watermark": false
  }'
```

### 텍스트로 투명 이미지 생성

```json 요청 본문 theme={null}
{
  "model": "dola-seedream-5-5-261028",
  "prompt": "투명 배경의 만화 스타일 로켓 스티커",
  "background": "transparent",
  "output_format": "png",
  "size": "1K"
}
```

```bash cURL theme={null}
curl --location 'https://api.gravitex.ai/v1/images/generations' \
  --header 'Authorization: Bearer sk-xxxxxxxxxx' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "dola-seedream-5-5-261028",
    "prompt": "투명 배경의 만화 스타일 로켓 스티커",
    "background": "transparent",
    "output_format": "png",
    "size": "1K"
  }'
```

## 성공 응답

`data[].url`을 읽어 24시간 이내에 저장하거나 `response_format: "b64_json"` 사용 시 `data[].b64_json`을 디코딩하세요. [응답 예시, 필드 및 사용량](https://docs.gravitex.ai/ko/api-reference/endpoint/seedream-5.5.md#성공-응답)

## 요금 및 오류 처리

텍스트-이미지는 참조 이미지 요금이 없으며 각 출력의 실제 픽셀 구간에 따라 과금됩니다.

[요금](https://docs.gravitex.ai/ko/api-reference/endpoint/seedream-5.5.md#요금) · [오류 처리](https://docs.gravitex.ai/ko/api-reference/endpoint/seedream-5.5.md#오류-처리)


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