# Seedream 5.0 Pro (https://wanapi.app/ko/docs/seedream-5-0-pro)
Seedream 5.0 Pro는 프롬프트로 이미지 한 장을 생성하고, 최대 10개의 참조 이미지를 편집하거나 조합하며, 이미지 한 장을 베이스 이미지와 최대 16개의 투명 레이어로 분리합니다. 1K, 1.5K, 2K 또는 직접 지정한 픽셀 크기로 출력합니다. [모델 상세 정보 및 플레이그라운드](/ko/models/seedream-5-0-pro)에서 확인하세요.
## Wan API 연동 [#wan-api-연동]
API 기본 URL은 `https://api.wanapi.app`입니다. [API 키 설정](/ko/settings/apikeys)에서 **Wan** 모델 제품군의 키를 만들고 `Authorization: Bearer YOUR_API_KEY`로 전송하세요. 키는 서버에 보관하세요. 플레이그라운드는 웹사이트 로그인 세션을 사용하며 같은 계정 잔액에서 요금이 차감됩니다.
`GET /v1/models`로 해당 키에서 사용할 수 있는 모델을 확인할 수 있습니다. Seedream 5.0 Pro는 OpenAI Images API를 사용합니다. `POST /v1/images/generations`에는 JSON을, `POST /v1/images/edits`에는 JSON 또는 multipart 업로드를 사용할 수 있습니다. 이미지가 준비되면 응답을 반환하며, 반복 조회할 작업은 없습니다.
| 설정 | Seedream 5.0 Pro |
| ------- | --------------------------------------------------------------------------------------- |
| 모델 ID | `bytedance/seedream-5.0-pro` |
| `size` | `1K`, `1.5K`, `2K`(기본값) 또는 총 921,600~~4,624,220픽셀과 1:16~~16:1 화면 비율 범위의 `WIDTHxHEIGHT`. |
| `image` | 참조 이미지 최대 10개. |
| 출력 | 요청당 이미지 한 장 또는 `layer_decomposition`을 사용하는 경우 베이스 이미지 한 장과 최대 16개의 레이어. |
## 이미지 생성 [#이미지-생성]
서버에서 `WAN_API_KEY`를 본인의 키로 설정하세요. 요청은 한 번만 전송하세요. 생성은 보통 1분 이내에 완료되며, 클라이언트 시간 제한은 최소 4분으로 설정하세요.
```bash
curl https://api.wanapi.app/v1/images/generations \
-H "Authorization: Bearer $WAN_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "bytedance/seedream-5.0-pro",
"prompt": "A minimalist magazine cover: a red fox in fresh snow at dawn, the bold serif title \"QUIET WILD\" across the top",
"size": "1K"
}'
```
응답은 OpenAI Images 형식을 따릅니다. 아래 값은 예시입니다.
```json
{
"created": 1792022400,
"data": [
{
"url": "https://cdn.example.com/image-1.jpg",
"size": "1024x1024",
"output_format": "jpeg"
}
],
"usage": {
"generated_images": 1
}
}
```
이미지 URL은 30일 동안 사용할 수 있습니다. 더 오래 보관하려면 파일을 직접 저장하세요. `"response_format": "b64_json"`을 전송하면 각 이미지를 Base64 형식으로 `b64_json`에서도 받을 수 있습니다.
## Seedream 5.0 Pro 요금 [#seedream-50-pro-요금]
생성된 각 이미지는 픽셀 크기에 따라 이미지당 공식 요금보다 30% 낮은 요금으로 과금됩니다. 261만 픽셀 이하(1K 및 1.5K)에는 낮은 요율이, 더 큰 이미지에는 높은 요율이 적용됩니다. 첫 번째 참조 이미지는 무료이며 추가 참조 이미지마다 참조 이미지 요금이 붙습니다. 이미지가 생성되기 전에 거부된 요청에는 요금이 부과되지 않습니다.
레이어 분리는 베이스 이미지와 반환된 모든 레이어에 과금합니다. 반환된 모든 이미지가 261만 픽셀 이하이면 각각 공식 레이어 요금보다 30% 낮은 요금이 적용됩니다. 하나라도 더 크면 모든 이미지에 각자의 크기에 맞는 공식 레이어 요율이 적용됩니다. `2K`에서는 항상 더 큰 이미지가 포함됩니다. 잔액은 최대 17장의 비용을 충당할 수 있어야 하며, 실제로 반환된 이미지에만 요금이 부과됩니다.
## 요청 필드 [#요청-필드]
JSON 객체를 전송하세요. `model`은 필수이며, `layer_decomposition`이 `true`인 경우를 제외하면 `prompt`도 필수입니다. 정의되지 않은 필드는 거부됩니다.
| 필드 | 유형 | 규격 |
| ------------------------- | ---------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `model` | 문자열 | 필수: `bytedance/seedream-5.0-pro`. |
| `prompt` | 문자열 | 생성할 내용 또는 레이어 분리에서 분리할 요소를 지정합니다. 영어, 중국어와 다른 언어를 지원합니다. 영어 기준 약 600단어 이내로 작성하면 가장 좋은 결과를 얻을 수 있습니다. |
| `image` | 문자열 또는 string\[] | HTTP(S) URL 또는 형식을 소문자로 표기한 `data:image/;base64,...` 형태의 참조 이미지 최대 10개입니다. 형식: JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC, HEIF. 이미지당 최대 30 MB, 화면 비율 1:16\~16:1입니다. |
| `size` | 문자열 | 이미지 생성: `1K`, `1.5K`, `2K`(기본값) 또는 `WIDTHxHEIGHT`. 레이어 분리: `1K`, `1.5K`, `2K` 또는 `auto`(기본값). |
| `layer_decomposition` | 불리언 | 기본값은 `false`입니다. `true`는 PNG 또는 JPEG 이미지 한 장을 베이스 이미지와 최대 16개의 레이어로 분리합니다. |
| `optimize_prompt_options` | 객체 | `{"mode": "standard"}`(기본값) 또는 `{"mode": "fast"}`입니다. fast는 품질이 약간 낮아지는 대신 생성 시간을 줄입니다. |
| `output_format` | 문자열 | `jpeg`(기본값) 또는 `png`입니다. 레이어 분리에서는 베이스 이미지 형식을 지정하며 레이어는 항상 PNG입니다. |
| `background` | 문자열 | `opaque`(기본값) 또는 `transparent`입니다. transparent에는 알파 채널이 있는 입력 이미지가 정확히 한 장 필요하며 PNG로 출력해야 합니다. 레이어 분리와는 함께 사용할 수 없습니다. |
| `watermark` | 불리언 | 기본값은 `true`로 AI 생성 표시를 작게 추가합니다. 제거하려면 `false`를 전송하세요. |
| `nsfw_checker` | 불리언 | 기본값인 `true`는 콘텐츠 검사를 켜둡니다. `false`는 이 검사 없이 요청을 전송하며 요금은 같습니다. |
| `response_format` | 문자열 | `url`(기본값) 또는 `b64_json`. |
| `n` | 정수 | 선택 사항이며 값은 반드시 `1`이어야 합니다. |
이 모델은 `stream`, `sequential_image_generation`, `tools`, `seed`, `guidance_scale`, `mask`를 지원하지 않으며 해당 필드가 있으면 요청을 거부합니다.
## 참조 이미지 편집과 조합 [#참조-이미지-편집과-조합]
이미지 한 장과 편집 지시를 보내거나, 조합할 여러 이미지를 보내세요.
```json
{
"model": "bytedance/seedream-5.0-pro",
"prompt": "Place the perfume bottle from image 1 on the marble table from image 2, soft window light",
"image": [
"https://example.com/bottle.png",
"https://example.com/table.jpg"
],
"size": "2K",
"output_format": "png"
}
```
`POST /v1/images/edits`는 같은 필드를 받습니다. multipart를 사용할 때는 `image` 또는 `image[]` 필드로 파일을 업로드하고 `optimize_prompt_options`를 JSON 문자열로 전송하세요.
## 레이어 분리 [#레이어-분리]
```json
{
"model": "bytedance/seedream-5.0-pro",
"prompt": "Separate the title text, the parrot and the background",
"image": "https://example.com/poster.png",
"layer_decomposition": true,
"size": "2K"
}
```
응답에서는 베이스 이미지가 먼저 나옵니다. 각 레이어에는 쌓임 순서, 위치와 설명이 추가됩니다.
```json
{
"created": 1792022400,
"data": [
{ "url": "https://cdn.example.com/image-1.jpg", "size": "2048x2048", "output_format": "jpeg", "z_index": 0 },
{
"url": "https://cdn.example.com/image-2.png",
"size": "1273x265",
"output_format": "png",
"z_index": 1,
"bounding_box": { "absolute": [383, 120, 1655, 384], "normalized": [187, 59, 808, 188] },
"name": "Title text",
"description": "Yellow serif title text"
}
],
"usage": { "input_images": 1, "generated_images": 2 }
}
```
하나의 레이어라도 실패하면 요청 전체가 실패합니다. 프롬프트에서 제한보다 많은 레이어를 요청하면 일부 레이어 내용이 누락될 수 있습니다.
## 오류 [#오류]
오류는 OpenAI 오류 형식인 `{"error": {"message", "type", "code"}}`를 사용합니다.
| HTTP | `code` | 의미 |
| ---- | ------------------------------- | --------------------------------------------------------- |
| 400 | `invalid_request` 또는 유효성 검사 메시지 | 지원하지 않는 필드나 조합입니다. 요청을 수정하세요. 요금은 부과되지 않았습니다. |
| 400 | `content_policy_violation` | 프롬프트, 입력 이미지 또는 출력이 콘텐츠 정책에 따라 거부되었습니다. 요금은 부과되지 않았습니다. |
| 402 | 잔액 부족 | 다시 전송하기 전에 잔액을 충전하세요. |
| 429 | `rate_limited` | 요청이 너무 많습니다. 나중에 다시 시도하세요. |
| 502 | `submission_unknown` | 결과를 받지 못했으며 요청에는 요금이 부과되지 않았습니다. 다시 전송하기 전에 사용 로그를 확인하세요. |
| 503 | `upstream_unavailable` | 이미지 생성을 일시적으로 사용할 수 없으며 요청에는 요금이 부과되지 않았습니다. |
시간 초과가 발생하면 사용 로그를 먼저 확인하지 않은 채 요청을 자동으로 재시도하지 마세요.