curl --request POST \
  --url https://api.evolink.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "doubao-seedream-5.0-pro-layerize",
  "image_urls": [
    "https://example.com/poster.png"
  ],
  "quality": "auto",
  "output_format": "jpeg"
}
'

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

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "insufficient_quota",
    "message": "Insufficient quota. Please top up your account.",
    "type": "insufficient_quota"
  }
}

{
  "error": {
    "code": "model_access_denied",
    "message": "Token does not have access to model: doubao-seedream-5.0-pro-layerize",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests, please try again later",
    "type": "rate_limit_error"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Internal server error",
    "type": "api_error"
  }
}

Seedream

Seedream 5.0 Pro 레이어 분해

Seedream 5.0 Pro 레이어 분해(doubao-seedream-5.0-pro-layerize)는 이미지 한 장을 베이스 이미지와 여러 개의 독립 레이어로 분리합니다. 각 레이어는 투명 채널이 있는 PNG이며, 베이스 이미지 형식은 output_format을 따릅니다
입력 이미지는 정확히 1장이어야 합니다. prompt는 선택 사항이며, 지정하지 않으면 모델이 이미지 속 주요 요소를 모두 자동으로 인식해 하나씩 분리합니다
출력 장수는 분해 결과에 따라 결정되며(1~17장) 요청 파라미터로 제어할 수 없습니다. 레이어 중 하나라도 실패하면 요청 전체가 실패하며, 부분 성공은 없고 실패 시 전액 환불됩니다
비동기 처리 모드, 반환된 작업 ID로 조회. 작업 상세의 result_data에서 각 이미지에는 z_index(쌓임 순서, 베이스 이미지는 0, 레이어는 1부터 증가)가 포함되며, 레이어에는 추가로 bounding_box(absolute는 베이스 이미지 좌표계의 픽셀 좌표, normalized는 0~1000 범위), name, description이 포함됩니다
이 모델은 일반 생성보다 오래 걸리며, 약 120초가 소요됩니다
생성된 이미지 링크는 24시간 동안 유효하며, 즉시 저장해 주세요

POST

images

generations

curl --request POST \
  --url https://api.evolink.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "doubao-seedream-5.0-pro-layerize",
  "image_urls": [
    "https://example.com/poster.png"
  ],
  "quality": "auto",
  "output_format": "jpeg"
}
'

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

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "insufficient_quota",
    "message": "Insufficient quota. Please top up your account.",
    "type": "insufficient_quota"
  }
}

{
  "error": {
    "code": "model_access_denied",
    "message": "Token does not have access to model: doubao-seedream-5.0-pro-layerize",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests, please try again later",
    "type": "rate_limit_error"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Internal server error",
    "type": "api_error"
  }
}

인증

Authorization

string

header

필수

##모든 API는 Bearer Token 인증이 필요합니다##

API Key 받기:

API Key 관리 페이지를 방문하여 API Key를 받으세요

요청 헤더에 추가:

Authorization: Bearer YOUR_API_KEY

본문

application/json

model

enum<string>

기본값:doubao-seedream-5.0-pro-layerize

필수

이미지 생성 모델 이름

사용 가능한 옵션:

doubao-seedream-5.0-pro-layerize

예시:

"doubao-seedream-5.0-pro-layerize"

image_urls

string<uri>[]

필수

분해할 이미지 URL (필수)

참고:

정확히 1장이 필요하며, 누락하거나 2장 이상을 전달하면 오류가 발생합니다
지원 형식: .png, .jpeg, .jpg (일반 생성보다 엄격하며 webp 등은 거부됩니다)
이미지 크기: 최대 30MB
총 픽셀 수: [262144, 6000×6000], 즉 최소 512×512 (일반 생성보다 하한이 높음)
가로세로 비율(가로/세로) 범위: [1/16, 16]
이미지 URL은 서버에서 직접 접근할 수 있거나 접근 시 바로 다운로드가 시작되어야 합니다(일반적으로 .png, .jpg 같은 이미지 확장자로 끝납니다)

Required array length: 1 element

예시:

["https://example.com/poster.png"]

prompt

string

분리할 요소 지정 (선택)

세 가지 사용 방법:

지정하지 않음: 모델이 이미지 속 주요 요소를 모두 인식해 하나씩 분리합니다
자연어: 예: 앵무새와 제목 텍스트를 분리해 줘. 의미를 해석해 요소를 판별하고 레이어로 나눕니다
좌표 지정: <bbox> 태그로 위치를 지정합니다. 예: 제목 텍스트<bbox>179 58 809 197</bbox>. 정규화 좌표(0~1000) 사용을 권장합니다

예시:

"앵무새와 제목 텍스트를 분리해 줘"

quality

enum<string>

기본값:auto

출력 등급. 기본값은 auto

옵션: auto, 1K, 1.5K, 2K

설명:

레이어 모드는 등급만 허용하며, 비율(16:9 등)이나 픽셀 지정(2048x2048 등)을 전달하면 오류가 발생합니다
auto는 출력이 입력 이미지를 따른다는 뜻입니다. 원본 크기가 [921600, 4624220] 픽셀 범위 안이면 그대로, 1K 미만이면 1K로, 2K를 초과하면 2K로 출력됩니다
각 레이어는 원본 이미지에서의 가로세로 비율을 각각 유지하며, 베이스 이미지의 비율은 입력 이미지와 같습니다

과금 안내: 등급은 출력 이미지마다 해당 이미지의 픽셀 수로 판정합니다. 1K와 1.5K는 단가가 같으며, 출력 한 장이 2610000 픽셀을 초과하면 높은 등급 가격이 적용됩니다.

사용 가능한 옵션:

auto,

1K,

1.5K,

2K

예시:

"auto"

prompt_priority

enum<string>

기본값:standard

프롬프트 최적화 모드를 설정하는 데 사용되는 프롬프트 최적화 전략

옵션:

standard: 표준 모드, 더 높은 품질 출력, 더 긴 처리 시간
fast: 빠른 모드, 처리 시간이 더 짧고 품질은 표준 모드보다 약간 낮습니다

사용 가능한 옵션:

standard,

fast

예시:

"standard"

output_format

enum<string>

기본값:jpeg

출력 이미지 형식

옵션:

jpeg: JPEG 형식(기본값)
png: PNG 형식

참고: 이 파라미터는 베이스 이미지만 제어합니다. 분리된 레이어는 항상 투명 채널이 있는 png이며 이 설정의 영향을 받지 않습니다.

사용 가능한 옵션:

jpeg,

png

예시:

"jpeg"

callback_url

string<uri>

작업 완료 후 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 상태 코드를 반환하면 성공으로 간주, 다른 상태 코드는 재시도를 트리거

예시:

"https://your-domain.com/webhooks/image-task-completed"

응답

이미지 생성 작업이 성공적으로 생성되었습니다

created

integer

작업 생성 타임스탬프

예시:

1757165031

string

작업 ID

예시:

"task-unified-1757165031-seedream5prolayerize"

model

string

실제 사용된 모델 이름

예시:

"doubao-seedream-5.0-pro-layerize"

object

enum<string>

특정 작업 유형

사용 가능한 옵션:

image.generation.task

progress

integer

작업 진행률 (0-100)

필수 범위: 0 <= x <= 100

예시:

0

status

enum<string>

작업 상태

사용 가능한 옵션:

pending,

processing,

completed,

failed

예시:

"pending"

task_info

object

비동기 작업 정보

Show child attributes

type

enum<string>

작업 출력 유형

사용 가능한 옵션:

text,

image,

audio,

video

예시:

"image"

usage

object

사용량 및 과금 정보

Show child attributes

이미지 시리즈

비디오 시리즈

오디오 시리즈

텍스트 시리즈

계정 관리

작업 관리

파일 관리

Seedream 5.0 Pro 레이어 분해

인증

본문

응답