Felo API PlatformFelo API Platform
모델 목록으로 돌아가기

Doubao-Seedream-5.5 API

ByteDance Seed가 2026년 11월 9일 공개한 이미지 생성·편집 모델로, 최대 100회 편집에도 비편집 영역을 픽셀 단위로 유지하고 RGBA 투명 이미지를 기본 생성합니다.

Doubao-Seedream-5.5는 텍스트와 이미지를 입력받아 이미지를 출력하는 ByteDance Seed의 이미지 생성·편집 모델입니다. 최대 100회까지 연속 편집을 반복해도 편집하지 않은 영역을 픽셀 단위로 보존하며, 알파 채널을 포함한 RGBA 투명 에셋을 기본으로 생성합니다. 한 번의 출력에 불투명 기본 이미지 1장과 최대 99장의 투명 PNG 레이어를 포함해 최대 100개의 레이어를 만들 수 있습니다.

이미지 사실감이 개선되어 과노출과 플라스틱 같은 광택이 줄었고, 복잡한 글리프와 밀집된 작은 텍스트의 렌더링도 강화되었습니다. 여러 소재를 합성할 때 물리적 가림과 조명·그림자를 다시 계산해 자연스럽게 배치합니다. 이미지 한 장 생성에는 약 5~10초가 걸립니다.

전자상거래 마케팅 이미지, 광고 디자인, 영화·게임 에셋, 인테리어 디자인, 지식 시각화, 스토리보드, 스티커·캐릭터 에셋, UI 아이콘, 인포그래픽, 포스터 카피 등에 적합합니다. Doubao, Doubao Work, Jimeng에서 사용할 수 있으며 Volcano Ark API로도 접근할 수 있습니다.

업데이트:

모델 ID

doubao-seedream-5-5-261028
입력
text / image
출력
image

주요 특징

  • 최대 100회 연속 편집에도 비편집 영역 픽셀 보존
  • 알파 채널 포함 RGBA 투명 에셋 기본 생성
  • 출력당 최대 100개 투명 레이어 구성
  • 과노출·플라스틱 광택 줄인 사실감 개선
  • 복잡한 글리프와 작은 텍스트 렌더링 강화
  • 소재 합성 시 가림·조명·그림자 재계산

제공 업체

최저가
1 제공 업체

제공 업체별 API 요금을 비교하세요. 공급자를 선택하면 전체 요금과 적용 조건을 확인할 수 있습니다.

제공 업체 · 요금 상세
가동률
$0.007143$0.0064287$0.018571$0.0167139

벤치마크

  • 심각한 텍스트 손상률

    공식 평가 기준, 낮을수록 우수

    0.4%
  • 경미한 텍스트 손상률

    공식 평가 기준, 낮을수록 우수

    1.7%
  • 작은 텍스트 정확도

    공식 평가 기준

    95%

점수는 모델 제공 업체가 공개한 값입니다.

Quick Start

이미지 작업을 제출하고 상태를 조회한 뒤 이미지를 저장합니다. curl과 Python 3 표준 라이브러리만 사용합니다.

POST https://openapi.felo.ai/api/v1/images/generations

1API key 설정

Felo API Platform 계정에서 key를 만들고 환경 변수로 설정하세요.

export FELO_API_KEY="YOUR_API_KEY"

2첫 요청 보내기

선택 매개변수 값은 모델마다 달라 예제에서는 지정하지 않습니다. 추가 전에 Playground에서 확인하세요. 필드는 input 안이 아닌 model, prompt와 같은 수준에 둡니다.

curl --fail-with-body --max-time 60 "https://openapi.felo.ai/api/v1/images/generations" \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -o created.json \
  -d '{
  "prompt": "A studio product photo of a ceramic coffee cup on warm linen, soft morning light",
  "model": "doubao-seedream-5-5-261028"
}'

3작업 폴링

제출 후 task_id가 반환됩니다. queued 또는 running이면 3초마다 조회하고 succeeded, failed, interrupted이면 멈춥니다. 최대 30분 대기합니다. created.json을 보관하면 재제출 없이 같은 작업을 계속 조회할 수 있습니다.

python3 - <<'PY'
import json, os, time
from pathlib import Path
from urllib.parse import quote
from urllib.request import Request, urlopen

task = json.loads(Path("created.json").read_text())
task_id = task["task_id"]
url = "https://openapi.felo.ai/api/v1/images/generations/" + quote(task_id, safe="")
headers = {"Authorization": "Bearer " + os.environ["FELO_API_KEY"]}
deadline = time.monotonic() + 1800

while task["status"] in ("queued", "running"):
    if time.monotonic() >= deadline:
        raise TimeoutError(f"Keep task_id={task_id} to resume polling")
    time.sleep(3)
    with urlopen(Request(url, headers=headers), timeout=60) as response:
        task = json.load(response)
    if task.get("task_id") != task_id or task.get("kind") != "image":
        raise ValueError("Unexpected task response")
    print(task["status"])

if task["status"] != "succeeded":
    raise RuntimeError(task.get("error") or task["status"])
if not task.get("outputs"):
    raise ValueError("Task succeeded without image outputs")
Path("task.json").write_text(json.dumps(task))
print("Saved task.json")
PY

4출력 다운로드

성공하면 task.json의 outputs를 저장합니다. HTTPS URL, URL 객체, b64_json을 지원합니다. 서명 URL은 즉시 다운로드하세요. 이미지 다운로드에는 API Key가 필요하지 않습니다.

python3 - <<'PY'
import base64, json
from pathlib import Path
from urllib.request import urlopen

task = json.loads(Path("task.json").read_text())
if task.get("status") != "succeeded" or not task.get("outputs"):
    raise ValueError("No completed image outputs")
extensions = {"image/png": ".png", "image/jpeg": ".jpg", "image/webp": ".webp", "image/gif": ".gif", "image/avif": ".avif"}

for index, output in enumerate(task["outputs"], 1):
    item = output if isinstance(output, dict) else {}
    url = output if isinstance(output, str) else item.get("url") or item.get("unsigned_url")
    mime = item.get("media_type") or "image/png"
    if url and url.startswith("https://"):
        with urlopen(url, timeout=60) as response:
            data = response.read()
            mime = response.headers.get_content_type()
    elif url and url.startswith("data:image/") and ";base64," in url:
        header, encoded = url.split(",", 1)
        mime = header[5:].split(";", 1)[0]
        data = base64.b64decode(encoded, validate=True)
    elif item.get("b64_json"):
        data = base64.b64decode(item["b64_json"], validate=True)
    else:
        raise ValueError("Unrecognized image output")
    path = Path(f"image-{index}" + extensions.get(mime, ".bin"))
    path.write_bytes(data)
    print(path)
PY

전체 레퍼런스가 필요하신가요?

API 문서 →

자주 묻는 질문

모델 소개: Doubao-Seedream-5.5?

Doubao-Seedream-5.5는 텍스트와 이미지를 입력받아 이미지를 출력하는 ByteDance Seed의 이미지 생성·편집 모델입니다. 최대 100회까지 연속 편집을 반복해도 편집하지 않은 영역을 픽셀 단위로 보존하며, 알파 채널을 포함한 RGBA 투명 에셋을 기본으로 생성합니다. 한 번의 출력에 불투명 기본 이미지 1장과 최대 99장의 투명 PNG 레이어를 포함해 최대 100개의 레이어를 만들 수 있습니다. 이미지 사실감이 개선되어 과노출과 플라스틱 같은 광택이 줄었고, 복잡한 글리프와 밀집된 작은 텍스트의 렌더링도 강화되었습니다. 여러 소재를 합성할 때 물리적 가림과 조명·그림자를 다시 계산해 자연스럽게 배치합니다. 이미지 한 장 생성에는 약 5~10초가 걸립니다. 전자상거래 마케팅 이미지, 광고 디자인, 영화·게임 에셋, 인테리어 디자인, 지식 시각화, 스토리보드, 스티커·캐릭터 에셋, UI 아이콘, 인포그래픽, 포스터 카피 등에 적합합니다. Doubao, Doubao Work, Jimeng에서 사용할 수 있으며 Volcano Ark API로도 접근할 수 있습니다.

사용 요금은 어떻게 계산되나요?

이용하는 제공 업체의 요금과 실제 사용량에 따라 비용이 결정됩니다. 긴 입력 등에는 다른 요금이 적용될 수 있습니다.

어떤 입력을 지원하나요?

텍스트 입력과 이미지 입력을 모두 받아 이미지를 출력합니다. 이미지 편집과 생성을 함께 수행할 수 있습니다.

투명 배경 이미지도 만들 수 있나요?

네. 알파 채널을 포함한 RGBA 투명 에셋을 기본으로 생성하므로 별도 배경 제거 작업이 필요 없습니다.

편집을 여러 번 반복하면 결과가 흐트러지나요?

최대 100회 연속 편집까지 편집하지 않은 영역을 픽셀 단위로 보존합니다. 반복 편집에서도 비편집 영역의 일관성이 유지됩니다.

한 번에 레이어를 몇 개까지 만들 수 있나요?

출력 한 건당 최대 100개의 투명 에셋 레이어를 만들 수 있습니다. 불투명 기본 이미지 1장과 최대 99장의 투명 PNG 레이어로 구성됩니다.

어디에서 사용할 수 있나요?

Doubao, Doubao Work, Jimeng에서 사용할 수 있으며, Volcano Ark에서 API로도 접근할 수 있습니다.

이미지 한 장 생성에 얼마나 걸리나요?

이미지 한 장 생성에 약 5~10초가 소요됩니다.