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

Seedream 5.5 API

ByteDance Seed의 이미지 생성·편집 모델로, 최대 100회 반복 편집에도 원본 영역을 픽셀 단위로 보존하고 RGBA 투명 이미지를 출력합니다.

Seedream 5.5는 ByteDance Seed가 2026년 11월 9일에 공개한 전문가용 이미지 생성·편집 모델입니다. 텍스트와 이미지를 입력받아 이미지를 출력하며, 같은 이미지에 최대 100회까지 연속 편집을 반복해도 편집하지 않은 영역의 색상 변화나 디테일 손실이 일어나지 않습니다. 또한 완전 또는 부분 투명도를 지원하는 RGBA PNG를 기본으로 생성합니다.

영어와 중국어의 밀집된 작은 텍스트를 사실적으로 렌더링하고, 실제와 같은 질감과 자연스러운 조명을 표현합니다. 레이어 분해 기능으로 한 장의 이미지를 기본 이미지와 레이어로 나눌 수 있으며, 최대 100개의 결과물을 만들 수 있습니다. 각 레이어는 z-index, 바운딩 박스, 이름, 설명과 함께 반환됩니다.

이커머스 제품 비주얼, 마케팅 자료, 영화·TV 프리비주얼라이제이션, 게임 에셋, 패션 디자인, 오피스 문서 작업에 적합합니다. 물보라나 식물, 소품처럼 독립적인 에셋이나 밀집된 작은 텍스트가 들어간 신문 스타일 페이지, 인포그래픽, 패키징 비주얼 제작에도 활용할 수 있습니다.

업데이트:

모델 ID

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

주요 특징

  • 최대 100회 연속 편집에도 원본 영역 보존
  • 완전·부분 투명도 RGBA 생성
  • 영어·중국어 밀집 텍스트 렌더링
  • 레이어 분해로 최대 100개 출력
  • 레이어별 z-index·바운딩 박스 제공

제공 업체

1 제공 업체

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

제공 업체 · 요금 상세
가동률

벤치마크

  • MagicArena 심각한 텍스트 손상

    이미지 비율

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

    이미지 비율

    1.7%

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

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": "seedream-5-5"
}'

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
input_references

이미지 편집 시 예제 URL을 본인의 HTTPS 이미지 URL 또는 base64 이미지 data URL로 바꾸세요. 한 번 제출한 후 동일한 조회 및 저장 단계를 따릅니다.

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": "Keep the product and framing. Replace the background with a sunlit marble countertop.",
  "model": "seedream-5-5",
  "input_references": [
    {
      "type": "image_url",
      "image_url": {
        "url": "https://example.com/product.png"
      }
    }
  ]
}'

지원 매개변수

  • n
  • seed
  • resolution
  • aspect_ratio
  • input_references

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

API 문서 →

자주 묻는 질문

모델 소개: Seedream 5.5?

Seedream 5.5는 ByteDance Seed가 2026년 11월 9일에 공개한 전문가용 이미지 생성·편집 모델입니다. 텍스트와 이미지를 입력받아 이미지를 출력하며, 같은 이미지에 최대 100회까지 연속 편집을 반복해도 편집하지 않은 영역의 색상 변화나 디테일 손실이 일어나지 않습니다. 또한 완전 또는 부분 투명도를 지원하는 RGBA PNG를 기본으로 생성합니다. 영어와 중국어의 밀집된 작은 텍스트를 사실적으로 렌더링하고, 실제와 같은 질감과 자연스러운 조명을 표현합니다. 레이어 분해 기능으로 한 장의 이미지를 기본 이미지와 레이어로 나눌 수 있으며, 최대 100개의 결과물을 만들 수 있습니다. 각 레이어는 z-index, 바운딩 박스, 이름, 설명과 함께 반환됩니다. 이커머스 제품 비주얼, 마케팅 자료, 영화·TV 프리비주얼라이제이션, 게임 에셋, 패션 디자인, 오피스 문서 작업에 적합합니다. 물보라나 식물, 소품처럼 독립적인 에셋이나 밀집된 작은 텍스트가 들어간 신문 스타일 페이지, 인포그래픽, 패키징 비주얼 제작에도 활용할 수 있습니다.

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

이용하는 제공 업체의 요금과 실제 사용량에 따라 비용이 결정됩니다. 긴 입력 등에는 다른 요금이 적용될 수 있습니다. 실제 생성 비용을 기준으로 과금됩니다. 최종 금액은 청구 내역을 확인하세요.

어떤 입력과 출력을 지원하나요?

텍스트와 이미지를 입력으로 받고 이미지를 출력합니다. 투명도를 지원하는 RGBA PNG 출력도 가능합니다.

반복 편집을 많이 해도 이미지가 망가지지 않나요?

같은 이미지에 최대 100회까지 연속 편집을 반복해도 편집하지 않은 영역은 픽셀 단위로 유지됩니다. 색상 이동이나 디테일 손실, 이미지 열화가 발생하지 않습니다.

레이어 분해는 어떻게 동작하나요?

한 장의 이미지를 기본 이미지와 레이어로 나누며, 총 최대 100개의 결과물을 만들 수 있습니다. 각 레이어는 z-index, 바운딩 박스, 이름, 설명과 함께 반환됩니다.

작은 텍스트가 많은 이미지도 잘 처리하나요?

영어와 중국어의 밀집된 작은 텍스트를 사실적으로 렌더링합니다. 신문 스타일 페이지나 인포그래픽, 패키징 비주얼에 적합합니다.

Seedream 5.0 Pro와 비교해 어떤가요?

MagicArena의 여섯 가지 사용 사례 모두에서 품질 점수와 사용성 비율이 Seedream 5.0 Pro보다 향상되었습니다. 특히 영화·TV와 오피스 생산성 분야의 사용성 비율은 이전 버전의 두 배 이상입니다.

관련 모델