Seedream 5.0 Pro Layerize API로 이미지 한 장을 편집 가능한 레이어로 분리하기

이 글은 틀리기 쉬운 부분을 중심으로 다룹니다. "어떤 요소를 분리할지" 지정하는 세 가지 방법, 장당 과금 때문에 레이어 수가 비용의 주요 변수가 되는 이유, 그리고 일반 생성보다 엄격한 입력 제약입니다.

무엇을 돌려받는가

주목할 것은 베이스 이미지입니다. Layerize가 포스터에서 헤드라인을 떼어낼 때 그 자리에 구멍이 남지 않습니다. 글자 아래에 있던 내용이 재구성됩니다. 이것이 세그멘테이션 마스크와의 본질적인 차이이며, 결과물을 바로 디자인 툴에 넣을 수 있는 이유입니다.

레이어를 지정하는 세 가지 방법

1. prompt를 보내지 않기 — 자동 전체 분해

{
  "model": "doubao-seedream-5.0-pro-layerize",
  "image_urls": ["https://example.com/poster.png"],
  "quality": "auto",
  "output_format": "jpeg"
}

프롬프트를 전혀 주지 않으면 모델이 이미지 안의 주요 요소를 모두 스스로 찾아냅니다. 텍스트 블록, 피사체, 장식, 배경을 하나씩 독립 레이어로 분리합니다. 이것이 이 모델의 주된 용도이며, 복잡한 포스터라면 10장 이상으로 나뉘는 것이 보통입니다.

2. 자연어 — 원하는 요소를 지목하기

{
  "model": "doubao-seedream-5.0-pro-layerize",
  "prompt": "앵무새와 제목 텍스트를 분리해줘",
  "image_urls": ["https://example.com/poster.png"],
  "quality": "2K"
}

두세 개 요소만 필요하고 전체 분해 비용을 치르고 싶지 않을 때 사용합니다. 요소는 의미적으로 식별되므로 "제목 텍스트"라고만 해도 되고, 그것이 어디 있는지 알 필요가 없습니다.

3. bbox 좌표 — 영역을 정확히 지정하기

{
  "model": "doubao-seedream-5.0-pro-layerize",
  "prompt": "제목 텍스트<bbox>179 58 809 197</bbox>, 앵무새 1마리<bbox>330 274 641 991</bbox>",
  "image_urls": ["https://example.com/poster.png"],
  "quality": "1.5K"
}

비동기 흐름

1단계 — 작업 제출

curl -X POST https://api.evolink.ai/v1/images/generations \
  -H "Authorization: Bearer $EVOLINK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedream-5.0-pro-layerize",
    "image_urls": ["https://example.com/poster.png"],
    "quality": "auto"
  }'

돌아오는 것은 이미지가 아니라 작업 핸들입니다.

{
  "id": "task-unified-1757165031-seedream5prolayerize",
  "object": "image.generation.task",
  "model": "doubao-seedream-5.0-pro-layerize",
  "status": "pending",
  "progress": 0,
  "type": "image",
  "task_info": { "can_cancel": true, "estimated_time": 120 },
  "usage": { "billing_rule": "per_call", "credits_reserved": 39.168 }
}

2단계 — 완료까지 폴링

curl https://api.evolink.ai/v1/tasks/task-unified-1757165031-seedream5prolayerize \
  -H "Authorization: Bearer $EVOLINK_API_KEY"

3단계 — 레이어 읽기

입력 제약은 일반 생성보다 엄격하다

이 흐름에서 실패가 가장 많은 지점입니다. Layerize는 일반 Seedream 생성이 받아들이는 입력을 모두 받아들이지는 않습니다.

과금: 세는 것은 요청 수가 아니라 출력 이미지 수

EvoLink의 Layerize는 BytePlus 공식 가격보다 20% 저렴합니다.

실제 계산 예를 두 개 들면 이렇습니다.

걸려 넘어지기 쉬운 네 가지

1. 키를 생략하지 않고 "prompt": "" 를 보내기. 이 모델에서 가장 쓸모 있는 자동 감지가 무력화됩니다.
2. output_format: "png" 가 레이어에 적용된다고 착각하기. 이것은 베이스 이미지만 제어합니다. 레이어는 항상 alpha 채널이 있는 PNG입니다.
3. 실패를 부분 성공으로 처리하기. 부분 성공은 없습니다. 한 장이라도 실패하면 전체가 실패하고 전액 환불되므로, 재시도 로직은 "전부 아니면 전무"를 전제로 작성해야 합니다.
4. 링크를 만료시키기. 24시간이면 사라집니다. 폴링하는 같은 작업 안에서 다운로드하세요.

자주 묻는 질문

최대 몇 개의 레이어를 얻을 수 있나요?

레이어는 1~16장이며 여기에 베이스 이미지를 더해 최대 17장의 출력 이미지입니다. 장수를 지정할 수는 없고 분해 결과에 따라 결정됩니다.

어떤 요소를 레이어로 만들지 제어할 수 있나요?

레이어는 정말 투명한 PNG인가요?

한 번 호출에 얼마나 걸리나요?

레이어 하나가 실패하면 어떻게 되나요?

요청 전체가 실패하고(부분 성공은 없습니다) 전액 환불됩니다.

어떤 이미지든 분해할 수 있나요?

PNG 또는 JPEG여야 하고 총 픽셀 262,144 이상(예: 512×512), 30MB 미만, 종횡비 1:16 ~ 16:1 이어야 합니다. 일반 생성에서는 받아들여지는 webp도 여기서는 거부됩니다.