> ## Documentation Index
> Fetch the complete documentation index at: https://evolink.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Seedream 5.0 Pro 레이어 분해
> - Seedream 5.0 Pro 레이어 분해(doubao-seedream-5.0-pro-layerize)는 이미지 한 장을 베이스 이미지와 여러 개의 독립 레이어로 분리합니다. 각 레이어는 투명 채널이 있는 PNG이며, 베이스 이미지 형식은 `output_format`을 따릅니다
- 입력 이미지는 **정확히 1장**이어야 합니다. `prompt`는 선택 사항이며, 지정하지 않으면 모델이 이미지 속 주요 요소를 모두 자동으로 인식해 하나씩 분리합니다
- 출력 장수는 분해 결과에 따라 결정되며(`1`~`17`장) 요청 파라미터로 제어할 수 없습니다. 레이어 중 하나라도 실패하면 요청 전체가 실패하며, 부분 성공은 없고 실패 시 전액 환불됩니다
- 비동기 처리 모드, 반환된 작업 ID로 [조회](/ko/api-manual/task-management/get-task-detail). 작업 상세의 `result_data`에서 각 이미지에는 `z_index`(쌓임 순서, 베이스 이미지는 `0`, 레이어는 `1`부터 증가)가 포함되며, 레이어에는 추가로 `bounding_box`(`absolute`는 베이스 이미지 좌표계의 픽셀 좌표, `normalized`는 `0`~`1000` 범위), `name`, `description`이 포함됩니다
- 이 모델은 일반 생성보다 오래 걸리며, 약 `120`초가 소요됩니다
- 생성된 이미지 링크는 24시간 동안 유효하며, 즉시 저장해 주세요
## OpenAPI
````yaml ko/api-manual/image-series/seedream/seedream-5.0-pro-layerize-image-generate.json POST /v1/images/generations
openapi: 3.1.0
info:
title: doubao-seedream-5.0-pro-layerize 인터페이스
description: Seedream 5.0 Pro 레이어 분해 모델로 이미지 한 장을 베이스 이미지와 여러 편집 가능한 레이어로 분리합니다
license:
name: MIT
version: 1.0.0
servers:
- url: https://api.evolink.ai
description: 프로덕션 환경
security:
- bearerAuth: []
tags:
- name: 이미지 생성
description: AI 이미지 생성 관련 API
paths:
/v1/images/generations:
post:
tags:
- 이미지 생성
summary: doubao-seedream-5.0-pro-layerize 인터페이스
description: >-
- Seedream 5.0 Pro 레이어 분해(doubao-seedream-5.0-pro-layerize)는 이미지 한 장을
베이스 이미지와 여러 개의 독립 레이어로 분리합니다. 각 레이어는 투명 채널이 있는 PNG이며, 베이스 이미지 형식은
`output_format`을 따릅니다
- 입력 이미지는 **정확히 1장**이어야 합니다. `prompt`는 선택 사항이며, 지정하지 않으면 모델이 이미지 속 주요
요소를 모두 자동으로 인식해 하나씩 분리합니다
- 출력 장수는 분해 결과에 따라 결정되며(`1`~`17`장) 요청 파라미터로 제어할 수 없습니다. 레이어 중 하나라도 실패하면
요청 전체가 실패하며, 부분 성공은 없고 실패 시 전액 환불됩니다
- 비동기 처리 모드, 반환된 작업 ID로
[조회](/ko/api-manual/task-management/get-task-detail). 작업 상세의
`result_data`에서 각 이미지에는 `z_index`(쌓임 순서, 베이스 이미지는 `0`, 레이어는 `1`부터 증가)가
포함되며, 레이어에는 추가로 `bounding_box`(`absolute`는 베이스 이미지 좌표계의 픽셀 좌표,
`normalized`는 `0`~`1000` 범위), `name`, `description`이 포함됩니다
- 이 모델은 일반 생성보다 오래 걸리며, 약 `120`초가 소요됩니다
- 생성된 이미지 링크는 24시간 동안 유효하며, 즉시 저장해 주세요
operationId: createSeedreamLayerizeImageGeneration
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/ImageGenerationRequest'
examples:
auto_layerize:
summary: 자동 분해(prompt 미지정)
value:
model: doubao-seedream-5.0-pro-layerize
image_urls:
- https://example.com/poster.png
quality: auto
output_format: jpeg
prompt_layerize:
summary: 자연어로 대상 지정
value:
model: doubao-seedream-5.0-pro-layerize
prompt: 앵무새와 제목 텍스트를 분리해 줘
image_urls:
- https://example.com/poster.png
quality: 2K
bbox_layerize:
summary: bbox 좌표로 정확히 지정
value:
model: doubao-seedream-5.0-pro-layerize
prompt: >-
제목 텍스트179 58 809 197, 앵무새 1마리330 274 641
991
image_urls:
- https://example.com/poster.png
quality: 1.5K
responses:
'200':
description: 이미지 생성 작업이 성공적으로 생성되었습니다
content:
application/json:
schema:
$ref: '#/components/schemas/ImageGenerationResponse'
'400':
description: 요청 매개변수가 잘못되었습니다
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error:
code: invalid_request
message: Invalid request parameters
type: invalid_request_error
'401':
description: 인증되지 않았거나 토큰이 유효하지 않거나 만료되었습니다
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error:
code: unauthorized
message: Invalid or expired token
type: authentication_error
'402':
description: 할당량이 부족합니다. 충전이 필요합니다
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error:
code: insufficient_quota
message: Insufficient quota. Please top up your account.
type: insufficient_quota
'403':
description: 접근이 거부되었습니다
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error:
code: model_access_denied
message: >-
Token does not have access to model:
doubao-seedream-5.0-pro-layerize
type: invalid_request_error
'429':
description: 요청 한도를 초과했습니다
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error:
code: rate_limit_exceeded
message: Too many requests, please try again later
type: rate_limit_error
'500':
description: 서버 내부 오류
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error:
code: internal_error
message: Internal server error
type: api_error
components:
schemas:
ImageGenerationRequest:
type: object
required:
- model
- image_urls
properties:
model:
type: string
description: 이미지 생성 모델 이름
enum:
- doubao-seedream-5.0-pro-layerize
default: doubao-seedream-5.0-pro-layerize
example: doubao-seedream-5.0-pro-layerize
image_urls:
type: array
description: >-
분해할 이미지 URL (필수)
**참고:**
- **정확히 `1`장이 필요**하며, 누락하거나 `2`장 이상을 전달하면 오류가 발생합니다
- 지원 형식: `.png`, `.jpeg`, `.jpg` (일반 생성보다 엄격하며 webp 등은 거부됩니다)
- 이미지 크기: 최대 `30MB`
- 총 픽셀 수: `[262144, 6000×6000]`, 즉 최소 `512×512` (일반 생성보다 하한이 높음)
- 가로세로 비율(가로/세로) 범위: `[1/16, 16]`
- 이미지 URL은 서버에서 직접 접근할 수 있거나 접근 시 바로 다운로드가 시작되어야 합니다(일반적으로 `.png`,
`.jpg` 같은 이미지 확장자로 끝납니다)
items:
type: string
format: uri
minItems: 1
maxItems: 1
example:
- https://example.com/poster.png
prompt:
type: string
description: >-
분리할 요소 지정 (선택)
**세 가지 사용 방법:**
- **지정하지 않음**: 모델이 이미지 속 주요 요소를 모두 인식해 하나씩 분리합니다
- **자연어**: 예: `앵무새와 제목 텍스트를 분리해 줘`. 의미를 해석해 요소를 판별하고 레이어로 나눕니다
- **좌표 지정**: `` 태그로 위치를 지정합니다. 예: `제목 텍스트179 58 809
197`. 정규화 좌표(`0`~`1000`) 사용을 권장합니다
example: 앵무새와 제목 텍스트를 분리해 줘
quality:
type: string
description: >-
출력 등급. 기본값은 `auto`
**옵션:** `auto`, `1K`, `1.5K`, `2K`
**설명:**
- 레이어 모드는 **등급만 허용**하며, 비율(`16:9` 등)이나 픽셀 지정(`2048x2048` 등)을 전달하면
오류가 발생합니다
- `auto`는 출력이 입력 이미지를 따른다는 뜻입니다. 원본 크기가 `[921600, 4624220]` 픽셀 범위
안이면 그대로, 1K 미만이면 1K로, 2K를 초과하면 2K로 출력됩니다
- 각 레이어는 원본 이미지에서의 가로세로 비율을 각각 유지하며, 베이스 이미지의 비율은 입력 이미지와 같습니다
**과금 안내:** 등급은 출력 이미지마다 해당 이미지의 픽셀 수로 판정합니다. `1K`와 `1.5K`는 단가가 같으며,
출력 한 장이 `2610000` 픽셀을 초과하면 높은 등급 가격이 적용됩니다.
enum:
- auto
- 1K
- 1.5K
- 2K
default: auto
example: auto
prompt_priority:
type: string
description: |-
프롬프트 최적화 모드를 설정하는 데 사용되는 프롬프트 최적화 전략
**옵션:**
- `standard`: 표준 모드, 더 높은 품질 출력, 더 긴 처리 시간
- `fast`: 빠른 모드, 처리 시간이 더 짧고 품질은 표준 모드보다 약간 낮습니다
enum:
- standard
- fast
default: standard
example: standard
output_format:
type: string
description: >-
출력 이미지 형식
**옵션:**
- `jpeg`: JPEG 형식(기본값)
- `png`: PNG 형식
**참고:** 이 파라미터는 **베이스 이미지만 제어**합니다. 분리된 레이어는 항상 투명 채널이 있는 png이며 이
설정의 영향을 받지 않습니다.
enum:
- jpeg
- png
default: jpeg
example: jpeg
callback_url:
type: string
description: >-
작업 완료 후 HTTPS 콜백 주소
**콜백 타이밍:**
- 작업이 완료, 실패 또는 취소될 때 트리거됨
- 과금 확인 완료 후 전송
**보안 제한:**
- HTTPS 프로토콜만 지원
- 내부 IP 주소로의 콜백 금지 (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x
등)
- URL 길이는 `2048`자를 초과할 수 없음
**콜백 메커니즘:**
- 타임아웃: `10`초
- 실패 시 최대 `3`회 재시도 (`1`초/`2`초/`4`초 후 재시도)
- 콜백 응답 본문 형식은 작업 조회 API 응답 형식과 동일
- 콜백 주소가 2xx 상태 코드를 반환하면 성공으로 간주, 다른 상태 코드는 재시도를 트리거
format: uri
example: https://your-domain.com/webhooks/image-task-completed
ImageGenerationResponse:
type: object
properties:
created:
type: integer
description: 작업 생성 타임스탬프
example: 1757165031
id:
type: string
description: 작업 ID
example: task-unified-1757165031-seedream5prolayerize
model:
type: string
description: 실제 사용된 모델 이름
example: doubao-seedream-5.0-pro-layerize
object:
type: string
enum:
- image.generation.task
description: 특정 작업 유형
progress:
type: integer
description: 작업 진행률 (0-100)
minimum: 0
maximum: 100
example: 0
status:
type: string
description: 작업 상태
enum:
- pending
- processing
- completed
- failed
example: pending
task_info:
$ref: '#/components/schemas/TaskInfo'
description: 비동기 작업 정보
type:
type: string
enum:
- text
- image
- audio
- video
description: 작업 출력 유형
example: image
usage:
$ref: '#/components/schemas/Usage'
description: 사용량 및 과금 정보
ErrorResponse:
type: object
properties:
error:
type: object
properties:
code:
type: string
description: 오류 코드 식별자
message:
type: string
description: 오류 설명
type:
type: string
description: 오류 유형
TaskInfo:
type: object
properties:
can_cancel:
type: boolean
description: 작업 취소 가능 여부
example: true
estimated_time:
type: integer
description: 예상 완료 시간 (초)
minimum: 0
example: 120
Usage:
type: object
description: 사용량 및 과금 정보
properties:
billing_rule:
type: string
description: 과금 규칙
enum:
- per_call
- per_token
- per_second
example: per_call
credits_reserved:
type: number
description: 예상 소비 크레딧
minimum: 0
example: 39.168
user_group:
type: string
description: 사용자 그룹 카테고리
example: default
securitySchemes:
bearerAuth:
type: http
scheme: bearer
description: |-
##모든 API는 Bearer Token 인증이 필요합니다##
**API Key 받기:**
[API Key 관리 페이지](https://evolink.ai/dashboard/keys)를 방문하여 API Key를 받으세요
**요청 헤더에 추가:**
```
Authorization: Bearer YOUR_API_KEY
```
````