
Seedream 5.0 Pro 레이어 분리: 반환 결과와 과금 방식
Seedream 5.0 Pro API의 레이어 분리 입력 조건, 크기 옵션과 반환 데이터를 알아보세요. 레이어별 과금 방식으로 실행 전 비용을 확인할 수 있습니다.
Seedream 5.0 Pro 레이어 분리는 완성된 PNG 또는 JPEG 이미지 한 장을 받아 베이스 이미지와 최대 16개의 투명 PNG 레이어를 반환합니다. 각 레이어에는 쌓임 순서, 위치, 이름과 설명이 포함됩니다. 요청당이 아니라 반환된 이미지당 과금되며, 각 레이어에는 해당 픽셀 크기의 레이어 요율이 적용됩니다. API에서 이 기능은 layer decomposition이라고 하며 layer_decomposition: true로 켭니다. 1 2
ByteDance는 2026년 7월 8일 Seedream 5.0 Pro 출시와 함께 이 기능을 소개했습니다. 텍스트, 주요 피사체와 배경을 포함해 포스터를 10개가 넘는 레이어로 분리하는 모습을 공개했습니다. 피사체 뒤에 가려진 영역을 채워주므로 레이어를 옮겨도 빈 구멍이 남지 않습니다. 3 이 가이드는 전송할 내용과 반환 결과, 실행 전 비용을 예상하는 방법을 안내합니다. Seedream 5.0 Pro 플레이그라운드에서 레이어 분리 모드로 전환해 사용해 볼 수 있습니다.
어떤 입력을 보내야 하나요?
레이어 분리는 일반 이미지 생성과 같은 엔드포인트를 사용하지만 입력 조건이 더 엄격합니다. 1
| 필드 | 레이어 분리 조건 |
|---|---|
image | 이미지가 정확히 한 장 필요합니다. PNG 또는 JPEG, 최대 30 MB, 총 픽셀 수 512×512 |
prompt | 선택 사항입니다. 제목 텍스트와 앵무새 등 분리할 요소를 지정하세요. 프롬프트가 없으면 모델이 주요 요소를 스스로 분리합니다. |
size | 1K, 1.5K, 2K 또는 auto(기본값)입니다. 이 모드에서는 픽셀 크기를 직접 지정할 수 없습니다. |
output_format | jpeg(기본값) 또는 png이며 베이스 이미지에만 적용됩니다. 레이어는 항상 PNG입니다. |
auto는 베이스 이미지와 각 레이어가 921,600~4,624,220픽셀 범위에 있으면 원래 크기를 유지하고, 더 작으면 1K로 확대하고 더 크면 2K로 축소합니다. 각 요소의 고유한 화면 비율은 유지합니다. 고정된 프리셋을 사용하면 베이스 이미지는 선택한 크기로 출력되며 각 레이어는 그와 가까운 해상도로 출력됩니다. 1
Wan API에서 레이어 분리는 background: "transparent"와 함께 사용할 수 없습니다. 레이어에는 이미 실제 투명도가 포함되어 있으며, 두 옵션을 함께 사용한 요청은 과금 전에 거부됩니다.
어떤 결과를 반환하나요?
응답에서는 베이스 이미지(z_index: 0)가 먼저 나오고 각 레이어가 이어집니다.
| 필드 | 의미 |
|---|---|
url | PNG 레이어 또는 선택한 형식의 베이스 이미지입니다. |
size | 해당 출력의 픽셀 크기입니다. 예를 들어 제목 레이어는 1273x265입니다. |
z_index | 쌓임 순서입니다. 0은 베이스 이미지이며 숫자가 높을수록 위에 놓입니다. |
bounding_box.absolute | 베이스 이미지 안에서의 픽셀 단위 위치입니다. |
bounding_box.normalized | 같은 위치를 해상도와 무관하게 0~1000 척도로 나타냅니다. |
name, description | 공식 예시의 제목 텍스트처럼 모델이 해당 레이어에서 식별한 내용과 짧은 설명입니다. |
이 필드만으로 디자인 도구에서 구도를 다시 구성할 수 있습니다. 각 PNG를 해당 경계 상자 위치에 z_index 순서대로 배치하세요. 1
Seedream 5.0 Pro로 생성한 축제 포스터에서 제목, 날짜, 출연자 이름, 색소폰 연주자와 배경을 분리해 달라고 요청했습니다. 1.5K에서 베이스 이미지와 레이어 5개가 반환되었습니다. 왼쪽 베이스 이미지에는 텍스트와 연주자가 사라졌으며, 그 뒤의 배경이 채워져 있습니다.

각 레이어에는 프롬프트에 맞춰 "BLUE HOUR JAZZ headline" 같은 영어 name이 반환되었습니다. 작은 요소는 포스터에 보이는 것보다 큰 크기로 반환됩니다. 출연자 이름 레이어의 크기는 2011×202픽셀입니다.
이 기능을 연동할 때는 두 가지 동작에 유의해야 합니다. 하나의 레이어라도 실패하면 요청 전체가 실패하며 부분 결과는 없습니다. 또한 프롬프트에서 제한인 16개보다 많은 레이어를 요청하면 요청이 실패하는 대신 일부 레이어 내용이 누락될 수 있습니다. 1
레이어 분리 요금은 어떻게 계산되나요?
Seedream 5.0 Pro 레이어 분리의 공식 요율은 출력 이미지당 261만 픽셀 이하이면 US$0.0225, 초과하면 US$0.045입니다. 2 Wan API에서는 반환된 모든 이미지가 261만 픽셀 이하인 결과에 30% 낮은 요금인 이미지당 US$0.01575가 적용됩니다. 모든 2K 요청처럼 더 큰 이미지가 결과에 포함되면 각 이미지에 공식 요율이 적용됩니다. 현재 요금은 요금표에서 확인할 수 있습니다.
반환할 레이어 개수는 모델이 결정하므로 비용은 결과에 따라 달라집니다.
| 결과 | 공식 요금 | Wan API |
|---|---|---|
| 2K 베이스 이미지 + 작은 레이어 8개(각각 2.61 MP 이하) | US$0.045 + 8 × US$0.0225 = US$0.225 | US$0.225 |
| 2K 베이스 이미지 + 2.61 MP 초과 레이어 8개 | 9 × US$0.045 = US$0.405 | US$0.405 |
auto 또는 2K의 최대 결과: 2.61 MP 초과 이미지 17장 | 17 × US$0.045 = US$0.765 | US$0.765 |
1K 또는 1.5K의 최대 결과: 2.61 MP 이하 이미지 17장 | 17 × US$0.0225 = US$0.3825 | US$0.26775 |
2K 요청에서도 작은 요소에는 낮은 요율이 유지됩니다. 공식 예시의 1273×265 제목 레이어는 약 34만 픽셀입니다. 1
앞서 실행한 결과에서는 이미지 6장 모두 261만 픽셀 이하였습니다. 베이스 이미지는 1344×1792(약 241만 픽셀), 가장 큰 레이어는 1216×1662였습니다. 공식 요율로는 6 × US$0.0225 = US$0.135이며, 게이트웨이는 반환된 크기로 예상한 금액을 정확히 부과했습니다. 같은 결과에 Wan API 요금을 적용하면 6 × US$0.01575 = US$0.0945입니다.
Wan API에서는 요청을 시작하기 전에 잔액이 가능한 최대 결과의 비용을 충당할 수 있어야 합니다. 이후 실제 반환된 베이스 이미지와 레이어에만 요금이 부과됩니다. 1K 또는 1.5K를 선택하면 이 상한이 US$0.765에서 US$0.26775로 낮아지며, 일반적으로 모든 이미지가 할인된 낮은 요금 구간에 들어갑니다.
이미지 요금제가 레이어를 어떻게 계산하는지 확인하세요
이 기능을 위한 이미지 요금제를 구매하기 전에 과금 조건을 읽어보세요. 2026년 8월 게시물에서 한 BytePlus 고객은 레이어 분리를 위해 Seedream 5.0 Pro 이미지 요금제를 구매했지만 레이어 요청이 요금제의 이미지 할당량에서 차감되지 않고 종량제 요율로 레이어마다 과금되었다고 전했습니다. 지원팀은 이러한 구분이 "명확히 안내되지 않았을 수 있다"고 인정했습니다. 4 어떤 서비스를 사용하든 레이어가 패키지 할당량에서 차감되는지, 각 레이어의 요금은 얼마인지 확인하세요.
Wan API에서 실행하기
API 키와 함께 POST https://api.wanapi.app/v1/images/generations로 요청을 한 번 전송하세요. 모든 레이어가 준비되면 응답을 반환합니다.
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": "Separate the title text, the parrot and the background",
"image": "https://example.com/poster.png",
"layer_decomposition": true,
"size": "1.5K"
}'30일 이내에 레이어를 다운로드하세요. Seedream 5.0 Pro API 가이드에서 모든 필드, 전체 응답 구조와 오류 코드를 확인할 수 있습니다.
레이어 분리는 언제 사용하면 좋나요?
완성된 이미지가 있고 편집 가능한 요소가 필요할 때 사용하세요. 포스터 제목 교체, 제품 사진 이동, 레이어 단위로 작업하는 사람에게 단일 이미지 디자인을 전달하는 경우가 해당합니다. 새 그림이 필요하면 일반 생성이나 참조 편집을 사용하세요. 전체 레이어 구성이 아니라 투명 배경 위의 피사체 하나가 필요하면 투명 배경 모드를 사용하세요.
플레이그라운드에서 시작하세요. 이미지 한 장을 업로드하고 레이어 분리를 선택한 후 생성 전에 예상 비용을 확인하세요.
출처
- BytePlus ModelArk: image generation API, Seedream 5.0 Pro의
layer_decomposition,size,output_format과 응답 필드. 2026년 10월 23일 확인.
- BytePlus ModelArk: model pricing, Seedream 5.0 Pro 단일 이미지 및 레이어 분리 요율. 2026년 10월 23일 확인.
- ByteDance Seed: Introducing Seedream 5.0 Pro, 2026년 7월 8일 출시 게시물의 레이어 분리 부분. 2026년 10월 23일 확인.
- Reddit r/generativeAI: "PSA: Why BytePlus Seedream 5.0 Pro's Layer Separation marketing felt misleading", 2026년 8월 31일 게시된 고객 경험담. 2026년 10월 23일 확인.
더 많은 게시물

Seedance 2.5와 Seedance 2.0, 장면에 맞는 모델은?
Seedance 2.5와 Seedance 2.0의 길이, 참조 한도와 예시 설정을 비교합니다. 화질이나 속도를 단정하지 않고 공정한 동영상 테스트를 준비하세요.


Wan 3.0 API 가이드: 모델, 입력, 첫 동영상 준비
Wan 3.0, Wan 3.0 Prime, Wan 3.0 Pro, Wan 3.0 Prime Pro의 API 입력과 동영상 출력 사양을 비교하고 첫 테스트를 준비하는 방법을 안내합니다.


Seedance 2.0 Fast vs Mini: 무엇을 테스트할까요?
Seedance 2.0 Fast와 Mini의 제한, 참조 동영상 과금과 샘플을 비교하세요. 같은 제작 지시로 품질, 소요 시간과 쓸 만한 장면의 비용을 평가하세요.

Wan API 소식
서비스 업데이트와 모델 소식
구독하고 모델 소식, 서비스 업데이트 및 API 연동 정보를 받아보세요.