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

ByteDance Seed: Seedream 5.0 Flash API

ByteDance Seed의 Seedream 5.0 Flash는 빠른 이미지 생성과 비용 효율에 초점을 맞춘 모델로, 다중 참조 입력과 정밀한 대화형 편집, 레이어 분해를 지원합니다.

Seedream 5.0 Flash는 ByteDance Seed가 2026년 9월에 공개한 Seedream 5.0 시리즈의 속도 지향 모델입니다. 텍스트 프롬프트와 참조 이미지로 이미지를 생성하며, 최대 10장의 다중 참조 이미지를 입력해 구도를 합성할 수 있습니다. 출력 해상도는 1K에서 2K 범위이며, 2K를 초과하는 입력은 2K로 반환되고 자동 모드에서는 입력 해상도에 맞춰집니다.

이 모델은 사용자가 원이나 낙서, 박스로 지정한 영역만 수정하고 나머지는 원본 그대로 유지하는 정밀한 대화형 편집을 지원합니다. 포인트 앤 드래그 방식으로 대상을 정확히 선택할 수 있으며, 완성된 이미지를 피사체, 배경, 텍스트, 장식 요소 등 최대 16개의 편집 가능한 레이어로 분해해 투명 PNG와 위치, 쌓임 순서, 내용 설명을 함께 반환합니다. 또한 이미지 안에 다국어 텍스트를 근사치가 아닌 네이티브 방식으로 직접 렌더링합니다.

광고 배너 제작과 이커머스 상품 카탈로그, 가상 피팅, 편집 및 인쇄 출판, 앱과 UI 목업 디자인, 게임 아트 반복 작업 등 빠른 초안과 대량 변형이 필요한 작업에 적합합니다. Seedream 5.0 Pro가 이미지 품질을 우선하는 반면, Flash는 속도와 비용을 우선하는 모델입니다.

업데이트:

모델 ID

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

주요 특징

  • 빠른 이미지 생성과 비용 효율
  • 최대 10장 다중 참조 입력
  • 지정 영역만 수정하는 정밀 편집
  • 최대 16개 편집 가능 레이어 분해
  • 이미지 내 다국어 텍스트 네이티브 렌더링

제공 업체

1 제공 업체

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

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

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-0-flash"
}'

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-0-flash",
  "input_references": [
    {
      "type": "image_url",
      "image_url": {
        "url": "https://example.com/product.png"
      }
    }
  ]
}'

지원 매개변수

  • n
  • seed
  • resolution
  • aspect_ratio
  • input_references

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

API 문서 →

자주 묻는 질문

모델 소개: ByteDance Seed: Seedream 5.0 Flash?

Seedream 5.0 Flash는 ByteDance Seed가 2026년 9월에 공개한 Seedream 5.0 시리즈의 속도 지향 모델입니다. 텍스트 프롬프트와 참조 이미지로 이미지를 생성하며, 최대 10장의 다중 참조 이미지를 입력해 구도를 합성할 수 있습니다. 출력 해상도는 1K에서 2K 범위이며, 2K를 초과하는 입력은 2K로 반환되고 자동 모드에서는 입력 해상도에 맞춰집니다. 이 모델은 사용자가 원이나 낙서, 박스로 지정한 영역만 수정하고 나머지는 원본 그대로 유지하는 정밀한 대화형 편집을 지원합니다. 포인트 앤 드래그 방식으로 대상을 정확히 선택할 수 있으며, 완성된 이미지를 피사체, 배경, 텍스트, 장식 요소 등 최대 16개의 편집 가능한 레이어로 분해해 투명 PNG와 위치, 쌓임 순서, 내용 설명을 함께 반환합니다. 또한 이미지 안에 다국어 텍스트를 근사치가 아닌 네이티브 방식으로 직접 렌더링합니다. 광고 배너 제작과 이커머스 상품 카탈로그, 가상 피팅, 편집 및 인쇄 출판, 앱과 UI 목업 디자인, 게임 아트 반복 작업 등 빠른 초안과 대량 변형이 필요한 작업에 적합합니다. Seedream 5.0 Pro가 이미지 품질을 우선하는 반면, Flash는 속도와 비용을 우선하는 모델입니다.

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

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

어떤 입력을 지원하나요?

텍스트 입력과 이미지 입력을 지원하며, 최대 10장의 다중 참조 이미지를 받아 구도를 합성할 수 있습니다.

출력 해상도는 어떻게 되나요?

출력 해상도는 1K에서 2K 범위입니다. 2K를 초과하는 입력은 2K로 반환되고, 자동 모드에서는 입력 해상도에 맞춰집니다.

대화형 편집은 어떻게 작동하나요?

사용자가 원이나 낙서, 박스로 바꿀 영역을 지정하면 표시된 부분만 수정되고 나머지 장면은 자연스럽게 유지됩니다. 포인트 앤 드래그로 대상을 정확히 선택할 수도 있습니다.

레이어 분해는 무엇을 제공하나요?

완성된 이미지를 피사체, 배경, 텍스트, 장식 요소 등 최대 16개의 편집 가능한 레이어로 분해하고, 각 레이어를 투명 PNG로 반환하며 위치와 쌓임 순서, 내용 설명을 함께 제공합니다.

Seedream 5.0 Pro와 어떻게 다른가요?

Pro는 이미지 품질을 우선하고 Flash는 속도와 비용을 우선합니다. 두 모델은 대화형 편집과 레이어 분해 기능을 공유합니다.

관련 모델