Seedream 5.5 API 사용법: 투명 배경 PNG·레이어 분리, 장당 $0.035

Seedream 5.5는 ByteDance가 2026년 11월 12일 BytePlus ModelArk에 공개한 최신 Seedream 이미지 모델입니다. 5.0과 달리 생성 단계에서 바로 알파 채널이 있는 PNG를 출력하고, 포스터 속 글자의 글꼴과 색상까지 레이어별로 읽어 냅니다.

항목	내용
모델 ID	`seedream-5-5-261028`
엔드포인트	`POST https://api.laozhang.ai/v1/images/generations`, JSON 본문
지원 작업	텍스트→이미지, 참조 이미지 편집(최대 10장), 레이어 분리. 모두 같은 엔드포인트
가격	출력 이미지당 $0.035(1K·1.5K·2K 동일), 참조 이미지 1장당 $0.008 추가
출력 크기	`1K`, `1.5K`, `2K`(기본값) 또는 픽셀 지정. 3K·4K 없음
기본 출력 형식	`png`
API 키	`default` 그룹, 과금 방식은 사용량 우선(권장) 또는 건당 과금
필요한 계정	LaoZhang API 계정만. BytePlus·Volcengine 계정 불필요

Seedream 5.5로 생성한, 따뜻한 조명이 켜진 밤의 서점 창가에서 책 더미 위에 잠든 고양이와 OPEN LATE 손글씨 간판 — 텍스트→이미지 예제의 출력: 2K, 2496×1664

Seedream 5.5로 배경 없이 생성한 파란 꽃무늬 세라믹 머그컵 제품 이미지 — 투명 배경 PNG 예제의 출력: 1K, 1024×1024 RGBA

Seedream 5.0과 비교

항목	Seedream 5.5	Seedream 5.0 Flash / 5.0 Pro
투명 배경 출력	생성·편집 요청에 `background` 지정	레이어 분리로 투명 소재 추출
레이어 분리	배경 + 최대 99개 레이어, `max_images`, 텍스트 스타일 인식	배경 + 최대 16개 레이어
기본 출력 형식	PNG	JPEG
이미지당 가격	$0.035	Flash $0.018, Pro $0.12
참조 이미지 요금	장당 $0.008	Flash 없음, Pro는 두 번째부터 장당 $0.003

작업별로 이렇게 고르세요.

투명 배경 소재, 세밀한 레이어, 포스터 텍스트 인식: Seedream 5.5
저렴한 대량 생성: Seedream 5.0 Flash
3K·4K 출력이나 연속 생성(그룹 모드): Seedream 5.0, 4.5, 4.0. 사용법은 Seedream API 가이드에 있습니다.

호출 전 준비

API 키 발급

Seedream 5.5는 출력 이미지 장수로 과금하는 건당 과금 모델입니다. 토큰 관리에서 API 키(콘솔에서는 ‘토큰’)를 만들고, 그룹은 default, 과금 방식(计费模式)은 사용량 우선(按量优先, 권장) 또는 건당 과금(按次计费)으로 설정합니다. 사용량 우선 키는 사용량 과금 모델도 호출할 수 있습니다.

환경 변수와 라이브러리

키는 서버 측 환경 변수에 보관하세요. Python 예제에서 쓰는 requests와, 투명 PNG 확인과 레이어 재합성에 쓰는 Pillow를 설치합니다.

export LAOZHANG_API_KEY="YOUR_LAOZHANG_API_KEY"
python3 -m pip install requests pillow

저장 스크립트 추가

cURL 응답 JSON에서 이미지를 저장하는 스크립트입니다. save_images.py로 저장해 두면 아래 cURL 예제에서 그대로 씁니다. 응답의 output_format을 보고 확장자를 정하고, url과 b64_json을 모두 처리합니다.

save_images.py

import base64
import json
import sys
import urllib.request
from pathlib import Path

response_file, stem = sys.argv[1], sys.argv[2]
payload = json.loads(Path(response_file).read_text(encoding="utf-8"))
items = payload.get("data") or []
if not items:
    sys.exit(f"{response_file}에 이미지가 없습니다: {payload.get('error', payload)}")

for number, item in enumerate(items, start=1):
    if item.get("b64_json"):
        image = base64.b64decode(item["b64_json"])
    else:
        with urllib.request.urlopen(item["url"], timeout=120) as download:
            image = download.read()
    extension = "jpg" if item.get("output_format") == "jpeg" else "png"
    path = Path(f"{stem}-{number}.{extension}")
    path.write_bytes(image)
    print(f"저장 완료: {path} ({item.get('size')}, background={item.get('background')})")

Seedream 5.5 API로 이미지 생성

위 왼쪽 샘플 이미지를 만든 요청입니다. 워터마크 없이 2K로 생성하고 응답을 seedream-5-5-bookstore.json에 저장합니다.

curl --fail-with-body "https://api.laozhang.ai/v1/images/generations" \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-5-5-261028",
    "prompt": "A cozy bookstore window at night with warm light, a cat sleeping on a stack of books, and a hand-lettered sign that reads \"OPEN LATE\"",
    "size": "2K",
    "response_format": "url",
    "watermark": false
  }' \
  -o seedream-5-5-bookstore.json

python3 save_images.py seedream-5-5-bookstore.json seedream-5-5-bookstore

성공하면 data[]에 이미지 URL과 함께 실제 크기, 형식, 배경 종류가 담깁니다.

{
  "model": "dola-seedream-5-5-261028",
  "created": 1794532840,
  "data": [
    {
      "url": "https://example.com/seedream-5-5.png",
      "size": "2496x1664",
      "output_format": "png",
      "background": "opaque"
    }
  ],
  "usage": {
    "input_images": 0,
    "generated_images": 1
  }
}

생성 시간은 2K에서 보통 25~~35초, 1K에서 12~~20초입니다. 해상도 단계를 보내면 모델이 내용에 맞춰 종횡비를 고르므로, 이 예제는 2496×1664 가로 이미지가 나왔습니다. 비율을 고정하려면 2048x2048처럼 픽셀을 지정하세요.

Python으로 생성하기

같은 요청을 Python으로 보내고, 응답의 output_format에 맞는 확장자로 저장합니다.

import base64
import os
from pathlib import Path

import requests

response = requests.post(
    "https://api.laozhang.ai/v1/images/generations",
    headers={"Authorization": f"Bearer {os.environ['LAOZHANG_API_KEY']}"},
    json={
        "model": "seedream-5-5-261028",
        "prompt": (
            "A cozy bookstore window at night with warm light, a cat sleeping on "
            'a stack of books, and a hand-lettered sign that reads "OPEN LATE"'
        ),
        "size": "2K",
        "response_format": "url",
        "watermark": False,
    },
    timeout=180,
)
response.raise_for_status()
item = response.json()["data"][0]

if item.get("b64_json"):
    image = base64.b64decode(item["b64_json"])
else:
    download = requests.get(item["url"], timeout=120)
    download.raise_for_status()
    image = download.content

extension = "jpg" if item.get("output_format") == "jpeg" else "png"
output = Path(f"seedream-5-5-bookstore.{extension}")
output.write_bytes(image)
print(f"저장 완료: {output} ({item['size']})")

투명 배경 PNG 만들기

background를 transparent로, output_format을 png로 보내면 배경이 없는 RGBA 이미지를 바로 받습니다. 위 오른쪽 머그컵 샘플을 만든 요청입니다.

curl --fail-with-body "https://api.laozhang.ai/v1/images/generations" \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-5-5-261028",
    "prompt": "A ceramic coffee mug with small blue flowers, product shot",
    "background": "transparent",
    "output_format": "png",
    "size": "1K",
    "response_format": "url",
    "watermark": false
  }' \
  -o seedream-5-5-mug.json

python3 save_images.py seedream-5-5-mug.json seedream-5-5-mug
python3 -c "from PIL import Image; print(Image.open('seedream-5-5-mug-1.png').mode)"

응답의 data[].background가 transparent이고, 마지막 명령이 RGBA를 출력하면 알파 채널이 있는 PNG입니다. background에는 세 가지 값이 있습니다.

auto(기본값): 프롬프트와 output_format을 보고 모델이 정합니다. jpeg는 알파 채널이 없으므로 항상 불투명합니다.
transparent: 배경이 투명한 RGBA 이미지를 반환합니다.
opaque: 배경이 채워진 RGB 이미지를 반환합니다.

background는 텍스트→이미지와 참조 이미지 편집 모두에서 쓸 수 있습니다. 레이어 분리 요청에는 함께 보낼 수 없으며, 보내면 오류가 반환됩니다.

참조 이미지 여러 장으로 편집

image에 참조 이미지를 넣으면 편집 요청이 됩니다. 한 장은 문자열로, 여러 장은 최대 10장까지 배열로 보냅니다.

각 항목은 공개 URL이거나 data:image/png;base64,... 형식의 data URL입니다. 형식 이름은 png, jpeg처럼 소문자로 씁니다.
배열 순서대로 이미지 1, 이미지 2가 되므로 프롬프트에서 이 번호로 가리킵니다.
참조 이미지별 형식·용량·크기 제한은 다른 Seedream 버전과 같습니다. Seedream API 가이드의 자주 묻는 질문 중 “로컬 이미지는 어떻게 보내고, 제한은 무엇인가요?”를 참고하세요.

다음 예제는 로컬 파일 product.png와 scene.jpg를 data URL로 보냅니다. 출력 1장($0.035)에 참조 이미지 2장($0.008 × 2)이 더해져 $0.051입니다.

IMG1=$(base64 < product.png | tr -d '\n')
IMG2=$(base64 < scene.jpg | tr -d '\n')

curl --fail-with-body "https://api.laozhang.ai/v1/images/generations" \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- \
  -o seedream-5-5-edit.json <<EOF
{
  "model": "seedream-5-5-261028",
  "prompt": "이미지 1의 제품을 이미지 2의 장면 속 테이블 위에 자연스럽게 놓아 주세요. 제품의 형태, 라벨, 색상은 그대로 유지하세요.",
  "image": [
    "data:image/png;base64,$IMG1",
    "data:image/jpeg;base64,$IMG2"
  ],
  "size": "2K",
  "response_format": "url",
  "watermark": false
}
EOF

python3 save_images.py seedream-5-5-edit.json seedream-5-5-edit

제품 사진을 배경 없이 받고 싶다면 같은 요청에 "background": "transparent"와 "output_format": "png"를 추가하세요.

레이어 분리: 이미지 한 장을 투명 PNG 레이어로

layer_decomposition을 true로 보내면 완성된 이미지 한 장을 배경과 투명 PNG 레이어로 나눕니다. 레이어 하나에 요소 하나가 담기며, 레이어는 최대 99개까지 나옵니다. 요청 조건은 다음과 같습니다.

image에는 이미지를 정확히 한 장 보냅니다. png 또는 jpeg, 총 픽셀 512×512 이상, 30MB 이하여야 합니다.
background와 함께 보낼 수 없습니다.
1K에서 레이어 응답은 보통 20~30초, 2K는 더 오래 걸립니다. 클라이언트 타임아웃은 300초 이상으로 잡으세요.

layer_decomposition_options로 결과를 조절합니다.

max_images: 배경을 포함해 반환할 최대 이미지 수. 2~100, 기본값 30입니다. 과금 상한이기도 하므로 처음에는 작게 잡으세요.
text_recognition: true면 일반 텍스트 레이어에 글자 내용과 스타일 정보를 붙입니다.

curl --fail-with-body --max-time 360 "https://api.laozhang.ai/v1/images/generations" \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-5-5-261028",
    "image": "https://example.com/your-poster.jpg",
    "layer_decomposition": true,
    "layer_decomposition_options": {
      "max_images": 3,
      "text_recognition": true
    },
    "size": "1K",
    "response_format": "url",
    "watermark": false
  }' \
  -o seedream-5-5-layers.json

python3 save_images.py seedream-5-5-layers.json seedream-5-5-layer

image URL은 공개적으로 내려받을 수 있는 자신의 이미지로 바꾸거나 data URL로 보내세요. max_images가 3이므로 배경을 포함해 최대 3장이 반환되며, 3장이면 3 × $0.035 + $0.008 = $0.113입니다.

레이어 응답과 텍스트 인식 결과

data[]의 첫 항목은 배경(z_index 0, background는 opaque)이고, 나머지는 요소 하나씩 담긴 투명 PNG 레이어입니다. 레이어마다 다음 필드가 있습니다.

bounding_box.absolute, bounding_box.normalized: 배경 위 레이어 위치
name, description: 모델이 붙이는 영어 이름과 설명
text_recognition: text_recognition을 켰을 때 일반 텍스트 레이어에만 붙음

아래는 여름 포스터를 분리했을 때 받은 텍스트 레이어 하나를 줄인 것입니다.

{
  "size": "1616x649",
  "output_format": "png",
  "z_index": 2,
  "bounding_box": {"absolute": [0, 0, 836, 336], "normalized": [0, 0, 1000, 268]},
  "name": "Bold uppercase text \"SUMMER\"",
  "background": "transparent",
  "text_recognition": {
    "text": "SUMMER",
    "lines": [{"runs": [{"text": "SUMMER", "style": {"similar_font_family": "TikTok Sans", "foreground_color": "#FFFFFF", "bold": true, "italic": false}}]}]
  }
}

text_recognition에는 인식한 전체 글자와 함께, 줄(lines)마다 구간(runs)별 스타일이 담깁니다. 스타일 값은 다음과 같습니다.

similar_font_family: 가장 비슷한 글꼴 이름
foreground_color: 글자 색(예: #FFFFFF)
bold, italic, underline, strikethrough: 글자 꾸밈
shadow, translucent: 그림자와 반투명 여부

장식용 아트 텍스트와 손글씨에는 text_recognition이 붙지 않습니다.

레이어를 다시 합치기

레이어 PNG의 픽셀 크기는 bounding box 크기와 다를 수 있습니다. 위 예에서 1616×649 PNG가 836×336 상자에 들어가므로, 다시 합칠 때는 각 레이어를 absolute 상자 크기에 맞게 조정하세요. 필드별 의미는 레이어 응답 읽기에, 레이어를 저장하고 배경 위에 다시 합치는 Pillow 스크립트 save_layers.py는 레이어 저장과 이미지 재합성에 있습니다. Seedream 5.5 응답에도 그대로 쓸 수 있습니다.

파라미터

파라미터	타입	기본값	설명
`model`	string	—	`seedream-5-5-261028`(필수)
`prompt`	string	—	이미지 설명 또는 편집 지시
`image`	string 또는 array	—	참조 이미지. 공개 URL 또는 data URL, 최대 10장. 레이어 분리는 정확히 1장
`size`	string	`2K`	`1K`, `1.5K`, `2K` 또는 `WIDTHxHEIGHT` 픽셀
`output_format`	string	`png`	`png` 또는 `jpeg`
`background`	string	`auto`	`auto`, `transparent`, `opaque`. 레이어 분리와 함께 쓸 수 없음
`response_format`	string	`url`	`url` 또는 `b64_json`
`watermark`	boolean	`true`	`true`면 “AI generated” 표시를 넣음. 없애려면 `false`
`layer_decomposition`	boolean	—	`true`면 참조 이미지 1장을 배경과 레이어로 분리
`layer_decomposition_options.max_images`	integer	`30`	배경 포함 최대 반환 수, 2~100
`layer_decomposition_options.text_recognition`	boolean	—	`true`면 텍스트 레이어에 글자와 스타일 정보 추가
`optimize_prompt_options.mode`	string	`standard`	`standard`만 허용

size를 픽셀로 보낼 때는 다음을 지키세요.

너비와 높이 사이에는 곱셈 기호 ×가 아니라 영문자 x를 씁니다. 예: 2048x2048, 2848x1600
총 픽셀은 921,600(1280x720)~4,624,220 사이여야 합니다.
종횡비는 1/16~16입니다.

다음 기능은 Seedream 5.5에서 지원하지 않으므로 관련 필드를 요청에 넣지 마세요.

sequential_image_generation(연속 생성, 그룹 모드)
stream(스트리밍)
웹 검색

가격과 과금

출력 이미지 한 장에 $0.035이며 1K, 1.5K, 2K 어느 크기든 같습니다. 참조 이미지는 첫 장부터 한 장당 $0.008이 더해집니다.

요청	계산	요청당 금액
텍스트→이미지 1장	$0.035	$0.035
참조 이미지 1장으로 편집	$0.035 + $0.008	$0.043
참조 이미지 2장으로 편집	$0.035 + $0.008 × 2	$0.051
참조 이미지 10장으로 편집	$0.035 + $0.008 × 10	$0.115
레이어 분리, 6장 반환	$0.035 × 6 + $0.008	$0.218

파라미터 오류나 모더레이션 차단처럼 200이 아닌 응답은 과금되지 않습니다.
클라이언트 타임아웃은 요청 취소가 아닙니다. 서버에서 생성이 끝났다면 과금되므로, 다시 보내기 전에 호출 로그를 확인하세요.
실제 청구 금액의 최종 기준은 호출 로그입니다.

레이어 분리는 배경을 포함해 반환된 이미지 수만큼 과금되며, 레이어 수는 모델이 정합니다.

max_images를 보내지 않으면 기본값 30이 적용되어, 한 요청이 최대 $1.058(30 × $0.035 + $0.008)까지 나올 수 있습니다.
max_images를 100으로 올리면 한 요청이 최대 $3.508입니다.
비용을 묶어 두려면 layer_decomposition_options.max_images를 필요한 만큼만 지정하세요.
타임아웃으로 연결을 끊어도 서버에서 분리가 끝났다면 과금됩니다. 레이어 요청의 타임아웃은 300초 이상으로 잡으세요.

모든 모델의 현재 가격은 AI 모델 API 가격표에 있습니다.

자주 묻는 질문

Seedream 5.5 모델 ID는 무엇인가요?

seedream-5-5-261028입니다. BytePlus 문서의 이름인 dola-seedream-5-5-261028로 보내도 같은 가격으로 호출되며, 응답의 model 필드에는 dola-seedream-5-5-261028이 표시됩니다.

Seedream 5.5 API는 이미지 한 장에 얼마인가요?

출력 이미지 한 장당 $0.035이며 1K, 1.5K, 2K 모두 같습니다. 참조 이미지를 쓰면 한 장당 $0.008이 추가되고, 레이어 분리는 배경을 포함해 반환된 장수만큼 과금됩니다. 계산 예는 위 가격과 과금 절에 있습니다.

Seedream 5.5에서 fast 모드를 쓸 수 있나요?

쓸 수 없습니다. optimize_prompt_options.mode는 standard만 받으며, fast를 보내면 HTTP 400이 반환되고 과금되지 않습니다. 오류 메시지에는 다음 문구가 들어 있습니다.

must be standard for Seedream 5.5

Seedream 계열에서 fast를 받는 모델은 5.0 Pro와 4.0뿐입니다.

Seedream 5.5로 4K 이미지를 만들 수 있나요?

만들 수 없습니다. 해상도 단계는 2K까지이고, 픽셀로 지정해도 총 4,624,220픽셀(예: 2048x2048, 2848x1600)이 상한입니다. 3K나 4K가 필요하면 Seedream 5.0, 4.5, 4.0을 쓰세요. 버전별 크기는 Seedream API 가이드에 정리되어 있습니다.

요청 한 번에 이미지를 여러 장 받을 수 있나요?

일반 생성과 편집에서는 받을 수 없습니다. Seedream 5.5는 연속 생성(sequential_image_generation, 그룹 모드)을 지원하지 않으므로, 필요한 장수만큼 요청을 나눠 보내세요. 응답 하나에 여러 장이 담기는 경우는 레이어 분리뿐입니다.

Seedream 5.5를 쓰려면 BytePlus 계정이 필요한가요?

필요 없습니다. LaoZhang API에 가입한 뒤 default 그룹 API 키만 있으면 됩니다. BytePlus나 Volcengine 계정은 필요하지 않습니다.

시작하기

이미지 생성·편집 API

비디오 생성 API

텍스트 API