> ## 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.5 레이어 분해
> > 🚧 **이 모델은 아직 제공되지 않습니다. 기대해 주세요**
- Seedream 5.5 레이어 분해 (doubao-seedream-5.5-layerize)는 이미지 한 장을 베이스 이미지와 여러 독립 레이어로 분리합니다
- 입력 이미지는 `1`장입니다. `prompt`는 선택 사항이며 생략하면 주요 요소를 자동으로 식별해 분리합니다
- `n`으로 최대 출력 수를 지정하고 `model_params.text_recognition`으로 문자 인식을 활성화할 수 있습니다
- 비동기 처리입니다. 반환된 작업 ID로 [작업 상태를 확인](/ko/api-manual/task-management/get-task-detail)하세요
- 생성된 이미지 링크는 24시간 동안 유효하며, 즉시 저장해 주세요
### 출력 안내
- `output_format`은 베이스 이미지 형식을 지정합니다. 독립 레이어는 항상 투명 채널이 있는 PNG로 출력됩니다
- `result_data` 내 각 이미지에는 `z_index`(쌓임 순서: 베이스 이미지는 `0`, 레이어는 `1`부터 증가)와 `background`(베이스 이미지는 `opaque`, 레이어는 `transparent`)가 포함됩니다. 레이어에는 `bounding_box`(`absolute`는 베이스 이미지 좌표계의 픽셀 좌표, `normalized`는 `0`~`1000` 범위), `name`, `description`도 포함됩니다
- 레이어 하나라도 실패하면 전체 작업이 실패하고 전액 환불됩니다. 부분 성공 결과는 반환되지 않습니다
### 과금 안내
- 베이스 이미지와 각 레이어는 개별 이미지로 과금됩니다. 입력 이미지는 별도로 과금됩니다
- 작업 생성 시 입력 이미지 `1`장과 최대 `n`장의 출력 이미지에 해당하는 크레딧을 사전 차감합니다. 완료 후 실제 출력 수로 정산하며 사용하지 않은 크레딧은 자동으로 반환됩니다
## OpenAPI
````yaml ko/api-manual/image-series/seedream-5.5/seedream-5.5-layerize-image-generate.json POST /v1/images/generations
openapi: 3.1.0
info:
title: doubao-seedream-5.5-layerize 인터페이스
description: Seedream 5.5 레이어 분해 모델로 이미지 한 장을 베이스 이미지와 여러 편집 가능한 레이어로 분리합니다
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.5-layerize 인터페이스
description: >-
> 🚧 **이 모델은 아직 제공되지 않습니다. 기대해 주세요**
- Seedream 5.5 레이어 분해 (doubao-seedream-5.5-layerize)는 이미지 한 장을 베이스 이미지와
여러 독립 레이어로 분리합니다
- 입력 이미지는 `1`장입니다. `prompt`는 선택 사항이며 생략하면 주요 요소를 자동으로 식별해 분리합니다
- `n`으로 최대 출력 수를 지정하고 `model_params.text_recognition`으로 문자 인식을 활성화할 수
있습니다
- 비동기 처리입니다. 반환된 작업 ID로 [작업 상태를
확인](/ko/api-manual/task-management/get-task-detail)하세요
- 생성된 이미지 링크는 24시간 동안 유효하며, 즉시 저장해 주세요
### 출력 안내
- `output_format`은 베이스 이미지 형식을 지정합니다. 독립 레이어는 항상 투명 채널이 있는 PNG로 출력됩니다
- `result_data` 내 각 이미지에는 `z_index`(쌓임 순서: 베이스 이미지는 `0`, 레이어는 `1`부터 증가)와
`background`(베이스 이미지는 `opaque`, 레이어는 `transparent`)가 포함됩니다. 레이어에는
`bounding_box`(`absolute`는 베이스 이미지 좌표계의 픽셀 좌표, `normalized`는 `0`~`1000`
범위), `name`, `description`도 포함됩니다
- 레이어 하나라도 실패하면 전체 작업이 실패하고 전액 환불됩니다. 부분 성공 결과는 반환되지 않습니다
### 과금 안내
- 베이스 이미지와 각 레이어는 개별 이미지로 과금됩니다. 입력 이미지는 별도로 과금됩니다
- 작업 생성 시 입력 이미지 `1`장과 최대 `n`장의 출력 이미지에 해당하는 크레딧을 사전 차감합니다. 완료 후 실제 출력
수로 정산하며 사용하지 않은 크레딧은 자동으로 반환됩니다
operationId: createSeedreamLayerizeImageGeneration
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/ImageGenerationRequest'
examples:
auto_layerize:
summary: 자동 분해(prompt 생략) 및 문자 인식
value:
model: doubao-seedream-5.5-layerize
image_urls:
- https://example.com/poster.png
quality: auto
output_format: png
'n': 30
model_params:
text_recognition: true
prompt_layerize:
summary: 자연어로 대상 지정
value:
model: doubao-seedream-5.5-layerize
prompt: 앵무새와 제목 텍스트를 분리해 줘
image_urls:
- https://example.com/poster.png
quality: 2K
bbox_layerize:
summary: bbox 좌표로 정확히 지정
value:
model: doubao-seedream-5.5-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.5-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.5-layerize
default: doubao-seedream-5.5-layerize
example: doubao-seedream-5.5-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: 앵무새와 제목 텍스트를 분리해 줘
'n':
type: integer
description: >-
베이스 이미지를 포함한 최대 출력 이미지 수입니다. 기본값은 `30`입니다.
**설명:**
- 허용 범위는 `2`~`100`입니다. 범위를 벗어나면 `400`이 반환되며 과금되지 않습니다
- 상한에 도달하면 분해를 종료하며 나머지 요소는 합쳐지거나 생략될 수 있습니다. 값을 늘리면 더 세밀하게 분리할 수
있습니다
- `n`이 클수록 사전 차감 크레딧이 늘어납니다. 완료 후 실제 출력 수로 정산하며 사용하지 않은 크레딧은 자동으로
반환됩니다
minimum: 2
maximum: 100
default: 30
example: 30
quality:
type: string
description: >-
출력 해상도입니다. 기본값은 `auto`입니다.
**옵션:** `auto`, `1K`, `1.5K`, `2K`
**설명:**
- 위의 해상도 옵션만 지원합니다. 비율(`16:9` 등)이나 픽셀 크기(`2048x2048` 등)를 전달하면 오류가
반환됩니다
- `auto`는 출력이 입력 이미지를 따른다는 뜻입니다. 원본 크기가 `[921600, 4624220]` 픽셀 범위
안이면 그대로, 1K 미만이면 1K로, 2K를 초과하면 2K로 출력됩니다
- 각 레이어는 원본 이미지에서의 가로세로 비율을 각각 유지하며, 베이스 이미지의 비율은 입력 이미지와 같습니다
enum:
- auto
- 1K
- 1.5K
- 2K
default: auto
example: auto
prompt_priority:
type: string
description: |-
프롬프트 최적화 모드입니다. `standard`만 지원하며 기본값도 `standard`입니다.
`fast`를 전달하면 `400`이 반환되며 과금되지 않습니다.
enum:
- standard
default: standard
example: standard
output_format:
type: string
description: >-
출력 이미지 형식
**옵션:**
- `png`: PNG 형식(기본값)
- `jpeg`: JPEG 형식
**참고:** 이 파라미터는 **베이스 이미지만 제어**합니다. 분리된 레이어는 항상 투명 채널이 있는 png이며 이
설정의 영향을 받지 않습니다.
enum:
- png
- jpeg
default: png
example: png
model_params:
type: object
description: 레이어 분해의 추가 옵션입니다. `text_recognition`만 허용하며 다른 키를 전달하면 `400`이 반환됩니다.
properties:
text_recognition:
type: boolean
description: >-
텍스트 레이어의 문자 인식 여부
- `false`: 레이어에 `name`, `description`, `bounding_box`만
포함됩니다(기본값)
- `true`: 정형적인 텍스트 레이어에 `text_recognition`이 추가됩니다. 전체 `text`(여러
줄은 `\n`으로 연결하며 위에서 아래, 그다음 왼쪽에서 오른쪽 순서), 각 줄의 `bounding_box`, 각
텍스트 구간의 `text`와 `style`(`similar_font_family`는 유사 글꼴,
`foreground_color`는 글자 색상, `bold` / `italic` / `underline` /
`strikethrough` / `shadow` / `translucent`는 스타일 플래그)을 포함합니다
아트 문자, 손글씨, 장식용 텍스트 레이어는 `text_recognition`을 반환하지 않습니다.
default: false
example: true
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-1793612934-seedream55layerize
model:
type: string
description: 실제 사용된 모델 이름
example: doubao-seedream-5.5-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: 150
Usage:
type: object
description: 사용량 및 과금 정보
properties:
billing_rule:
type: string
description: 과금 규칙
enum:
- per_call
- per_image
- per_token
- per_second
example: per_image
credits_reserved:
type: number
description: 예상 소비 크레딧
minimum: 0
example: 55.624
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
```
````
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.