소개
이 엔드포인트가 하는 일
Seedream 5.0 Pro 레이어 분해는 완성된 이미지 한 장을 받아 조각으로 분해합니다. 분리한 요소를 걷어내고 배경을 복원한 깨끗한 베이스 이미지와, 사람, 헤드라인, 제품, 소품 같은 요소별 투명 PNG가 돌아옵니다. 어떤 조각이든 옮기고, 크기를 바꾸고, 교체하고, 색을 바꾸거나 빼 버릴 수 있습니다.
중요한 입력값
image_url은 원본 이미지 한 장입니다(png, jpeg, webp, bmp, tiff, gif, 30MB 이하, HEIC는 지원하지 않음). prompt는 선택이며, 비워 두면 자동으로 감지하고, 원하는 요소를 적으면 그것을 분리하며, 0~1000 좌표의 <bbox>x1 y1 x2 y2</bbox>로 요소를 둘러쌀 수도 있습니다. resolution은 auto, 1k, 1.5k, 2k입니다. output_format(jpeg 또는 png)은 베이스 이미지에만 적용됩니다.
콘텐츠
필터 없는 원본 이미지도 분리할 수 있습니다. 보내 주신 이미지는 제공된 그대로 모델에 전달됩니다. 저희 테스트에서 모델은 매우 강함 단계의 원본 이미지를 거부했고, 요금은 청구되지 않았습니다.
돌려받는 것
첫 번째 이미지는 분리된 요소를 제거하고 배경을 채운 베이스 이미지입니다(layer.zIndex 0). 나머지 이미지는 모두 쌓인 순서대로 놓인 투명 PNG 레이어입니다. 각 레이어에는 베이스 이미지 픽셀 좌표로 [x1, y1, x2, y2] 형태의 boundingBox와 모델이 붙인 name이 담겨 있어서, 원래 있던 자리에 정확히 되돌릴 수 있습니다. 전체는 최대 17장이며, 과금은 베이스 이미지를 포함한 실제 장수를 따릅니다.
| 항목 | 값 |
|---|---|
| 입력 | 이미지 |
| 출력 | 이미지 |
| 엔드포인트 | Text to Image, Image to Image |
| 필수 입력 | 프롬프트(최대 5,000자), Image to Image는 레퍼런스 이미지 1~10장 추가 |
| 화면비 | 1:3~3:1 열다섯 가지, Image to Image 기본값은 auto(첫 번째 레퍼런스에 가장 가까운 비율) |
| 해상도 | 1k, 1.5k 또는 2k(기본 2k), 등급에 따라 픽셀 수와 가격이 정해짐 |
| 재현성 | seed 필드 없음 — 같은 요청도 매번 다른 프레임이 나옵니다 |
| 콘텐츠 정책 | 무검열, 성인 여부 플래그나 요청별 선언 없음 |
핵심 기능 및 하이라이트
가까이서 봐도 버티는 젖은 피부와 실크, 촛불 그림자
질감이 암시에 그치지 않고 실제로 렌더링되기 시작하는 단계입니다. 쇄골에 맺힌 물방울, 묵직한 실크의 무게감, 검은 배경에 떨어지는 소프트박스 하나의 감쇠. 방향이 이미 정해진 다음, 더 빠른 형제 대신 여기에 호출 하나를 쓸 이유가 그것입니다.
얼굴과 옷, 공간을 편집 한 번에 합칩니다
편집 엔드포인트가 레퍼런스 이미지를 한 장에서 열 장까지 받습니다. 프롬프트에서 각각 역할을 지정하세요. 예를 들어 첫 장에서 피사체, 셋째에서 의상, 다섯째에서 공간을 가져오는 식입니다. 그러면 하나의 프레임으로 구성해 줍니다. 레퍼런스가 늘어날 때마다 견적에 더해지고, 제출 전에 보이는 추정치대로 정산됩니다.
열다섯 가지 화면비, 그리고 원본의 형태를 지키는 편집
aspect_ratio는 1:3부터 3:1까지 피드용 4:5와 배너용 21:9를 포함한 열다섯 가지이고, resolution으로 1k, 1.5k 또는 2k 등급을 고릅니다. 편집 엔드포인트의 기본값은 auto입니다. 출력이 첫 번째 레퍼런스에 가장 가까운 지원 화면비를 따르므로, 세로 원본은 다른 형태를 지정하지 않는 한 세로로 돌아옵니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
image_url | 예 | 분리할 이미지 한 장: png, jpeg, webp, bmp, tiff 또는 gif, 30MB 이하, 총 픽셀 수 262,144 |
prompt | 아니요 | 선택 사항이며 길이 제한은 없습니다. 비워 두면 모델이 주요 요소를 스스로 고르고, 요소를 지정하면 그것들을 분리합니다. 1자 이상 · 5000자 이하 |
resolution | 아니요 | auto, 1k, 1.5k, 2k 중에서 고릅니다. 베이스 이미지는 입력의 화면비를 유지하고 각 레이어는 요소의 비율을 유지합니다. |
output_format | 아니요 | 베이스 이미지에만 적용되는 jpeg 또는 png입니다. 레이어는 무엇을 고르든 항상 투명 PNG입니다. |
요금
| 사양 | 요금 |
|---|---|
| $0.042 / 장 |
| $0.042 / 장 |
| $0.084 / 장 |
| $0.084 / 장 |
활용 사례
검열 없는 에디토리얼 최종본
촛불이 켜진 실내, 젖은 질감의 뷰티 포트레이트, 강한 빛 속의 실크 — 캠페인이 실제로 내보내는 프레임입니다. 설정할 연령 등급 플래그도, 별도 엔드포인트도 없으며, 같은 두 엔드포인트가 향수 스틸과 필터 없는 최종본을 똑같이 다룹니다.
뷰티와 향수 캠페인 스틸
강한 소프트박스 하나, 깊은 검정 배경, 광택 있는 피부와 물의 디테일까지 담아냅니다. 재질 표현이 충분히 가까워서 시안이 자리 표시용이라고 해명해야 하는 대신 클라이언트 검토를 통과합니다.
레퍼런스 열 장으로 하는 장면 조립
피사체 사진과 의상 레퍼런스 두 장, 소품 컷, 장소 촬영본을 편집 호출 하나에 보내고 각자 무엇을 주는지 밝히세요. 요청 하나가 합성 작업 한 세션을 대신하고, 조명은 손이 아니라 모델이 맞춰 줍니다.
정해진 방향의 마감 작업
구도는 더 빠른 모델에서 탐색하고, 효과가 있었던 문장을 가져와 여기서 납품할 프레임을 만드세요. 프롬프트를 다시 짤 필요는 없고, 다시 볼 만한 것은 레퍼런스 구성과 화면비, 해상도 등급뿐입니다.
프롬프트 가이드 및 실전 팁
생성인지 조립인지부터 정합니다
레퍼런스가 없으면 text-to-image, 한 장에서 열 장까지 있으면 편집 엔드포인트입니다. 편집에서는 aspect_ratio를 지정하지 않는 한 화면이 첫 번째 레퍼런스를 따릅니다. 둘 다 같은 5,000자 프롬프트를 받으므로, 고르는 기준은 브리프를 고쳐 쓰는 일이 아니라 출발 소재입니다.
트리트먼트를 쓰고, 화면을 정합니다
피사체와 의상, 광원과 방향, 렌즈, 색보정을 적으세요. 그다음 화면비와 1k, 1.5k 또는 2k 등급을 고르세요. 이 페이지의 포트레이트는 이 프롬프트에서 나왔습니다. "High-resolution beauty editorial photograph, close portrait of an adult woman with wet hair slicked back, water beading on her collarbone and bare shoulders, a heavy ivory silk robe slipping off one shoulder, arms folded across her chest, dramatic single softbox from camera left, glossy skin texture, deep black background, luxury fragrance campaign look."
작업을 폴링하고 브리프를 결과물과 함께 둡니다
작업을 만들고 종료 상태까지 폴링한 뒤 플랫폼 스토리지에서 이미지를 받으세요. seed 필드가 없어서 정확히 같은 프레임을 다시 그릴 방법이 없으니, 남기는 결과 옆에 프롬프트를 저장해 두세요.
소개
Seedream 5.0 Pro 레이어 분해는 완성된 이미지 한 장을 베이스 이미지와 투명 PNG 레이어 최대 16장으로 나눕니다. 각 레이어에는 위치 박스와 이름이 붙어 있어서 원래 구도를 다시 짜 맞추거나 캔버스에서 재배치할 수 있습니다.
ByteDance가 개발했습니다(모델 ID dola-seedream-5-0-pro-260628). 레이어가 원래 있던 자리로 정확히 돌아가야 할 때 사용하세요.
출발 소재로 모드 고르기
| 출발 소재 | 모드 |
|---|---|
| 부분별로 따로 필요한 완성 이미지 | Seedream 5.0 Pro 레이어 분해 |
| 글로 쓴 아트 디렉션이나 디자인 브리프 | Seedream 5.0 Pro 텍스트→이미지 |
| 손봐야 할 승인된 원본 이미지 | Seedream 5.0 Pro 이미지 편집 |
| 이름과 위치 박스도 붙는 같은 분리를 더 낮은 이미지당 가격으로 | Seedream 5.0 Flash 레이어 분해 |
레이어에는 Pro와 Flash 중 무엇을 쓸까
두 등급 모두 레이어마다 boundingBox와 name을 돌려줍니다. 같은 영화 포스터를 프롬프트 없이 실행했을 때 Pro는 이미지 9장, Flash는 8장을 돌려주었습니다. 차이는 가격과 콘텐츠 경계 하나입니다. 가격은 Pro가 출력 이미지당 1K와 1.5K에서 $0.042, 2K에서 $0.084이고, Flash는 모든 단계에서 $0.026입니다. Pro는 매우 강함 단계의 원본 이미지를 거부하지만, Flash는 같은 종류의 이미지를 인물별 레이어로 나눴습니다. 저희 테스트에서는 어느 쪽도 일관되게 더 빠르지는 않았습니다.
주요 특징
위치 박스와 이름
레이어마다 베이스 이미지 픽셀 기준의 [x1, y1, x2, y2] 형태 boundingBox와 ‘붉은 트렌치코트의 여성’ 같은 name이 돌아옵니다. 저희 포스터 테스트에서는 레이어를 각각의 박스 위치에 다시 쌓자 원본 포스터가 재현되었습니다. 레이어 PNG는 차지하는 박스보다 큰 경우가 많으므로(671×139 박스에 1233×256 PNG가 딸려 온 사례) 되돌릴 때는 박스에 맞춰 크기를 줄이세요.
깨끗한 베이스 이미지
분리된 요소는 제거되고 배경이 완성됩니다. 향수 광고를 분리하자 병, 리본, 글자가 있던 자리에 빈 검은 대리석 면이 남았습니다.
말이나 좌표로 유도하기
요소 이름을 지정하거나 <bbox> 좌표로 위치를 짚어 주세요. 프롬프트가 없으면 모델이 주요 요소를 스스로 고릅니다.
투명 PNG 레이어
output_format을 무엇으로 고르든 레이어는 항상 투명 PNG입니다. 이 설정으로 바뀌는 것은 베이스 이미지뿐입니다.
활용 사례
포스터의 글자 바꾸기
제목 레이어를 꺼내 교체하거나 스타일을 바꾼 뒤, 돌려받은 박스 위치에 모든 것을 다시 쌓으세요.
제품 배경 교체하기
광고에서 제품과 글자를 떼어 내고, 베이스 이미지는 두거나 교체해서 새 캠페인용으로 다시 구성하세요.
패럴랙스나 애니메이션용 소스 만들기
일러스트를 위치를 아는 순서 있는 레이어로 바꿔 뎁스 이동이나 리그에 쓰세요.
장면에서 사람 분리하기
사람만 지정하면 투명 레이어 한 장과 그 사람이 빠진 장면을 얻습니다.
프롬프트 가이드와 팁
원하는 조각을 지정하세요
포스터라면 쉬운 말로 나열하세요. “다이너 건물, 태그라인, LATE SHIFT 제목, 붉은 트렌치코트의 여성, ADMIT ONE 티켓 스텁을 분리해 주세요.” 이 실행에서는 이미지 6장이 돌아왔습니다. 베이스 이미지와 정확히 그 다섯 레이어입니다.
바운딩 박스로 요소 둘러싸기
요소 이름 뒤에 <bbox>x1 y1 x2 y2</bbox>를 덧붙이세요. 좌표는 왼쪽 위 모서리를 원점으로 0~1000으로 정규화되어 있어서 이미지의 픽셀 크기와 무관합니다.
Separate the title text <bbox>179 58 809 197</bbox> and the parrot <bbox>330 274 641 991</bbox> into independent layers
해상도 고르기
1k와 1.5k는 출력 이미지당 가격이 같고, 2k와 auto는 2K 요금입니다. auto가 2K로 출력할 수 있기 때문입니다. 작업용 분리면 충분할 때는 1k나 1.5k를 쓰세요.
선확보 금액에 대비하기
요청 시점에 17장 분량의 요금을 먼저 확보하고, 실제 레이어 수가 정해지면 차액을 환불합니다. 결과는 보통 몇 장입니다.
콘텐츠 경계
Seedream 5.0 Pro · 레이어 분해. SpicyAPI는 이 엔드포인트에 플랫폼 차원의 콘텐츠 필터를 추가하지 않습니다. 모델 자체의 제한은 그대로 적용되며 결과는 보장되지 않습니다. 저희 테스트에서는 매우 강함 단계를 제외하고 시도한 필터 없는 원본 이미지를 모두 분리했으며, 매우 강함 단계의 이미지는 모델이 거부했고 요금은 청구되지 않았습니다. 콘텐츠 정책을 준수할 책임은 이용자에게 있습니다.
필터 없는 원본 이미지도 분리할 수 있으나 결과는 보장되지 않습니다. 매우 강함 단계의 원본 이미지는 모델이 거부하며 요금은 청구되지 않습니다. 미성년자가 포함된 자료, 동의 없는 성적 이미지, 실제 인물을 사칭해 오인시키는 자료는 제출하지 마세요. 이는 이용 제한 사항이며 모든 요청을 자동 심사한다는 의미는 아닙니다.
상업적 이용의 적합성, 필요한 권리 확보, 최종 편집 검토는 이용자의 책임입니다.
API 빠른 시작
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "bytedance/seedream-5.0-pro/layer-decomposition",
"input": {
"image_url": "https://example.com/reference.png",
"output_format": "jpeg",
"resolution": "1.5k"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
인증, 전체 스키마, 폴링과 오류 처리는 API 레퍼런스에서 확인하세요.











