ByteDance Seed: Seedream 5.0 Pro API
ByteDance Seed의 플래그십 이미지 모델로, 디자인을 이해하고 다국어 텍스트와 편집 가능한 레이어를 생성합니다.
Seedream 5.0 Pro는 ByteDance Seed가 2026년 7월에 공개한 Seedream 5.0 패밀리의 플래그십 이미지 모델입니다. 텍스트와 이미지를 입력받아 이미지를 출력하며, 한 번의 생성으로 읽을 수 있는 작은 텍스트가 포함된 고밀도 인포그래픽, 차트, 순서도, 공정 다이어그램, 타임라인을 만들 수 있습니다.
점, 바운딩 박스, 화살표, 올가미, 러프 스케치 표시로 지정한 영역만 편집하면서 나머지 프레임은 그대로 유지하고, 텍스트 프롬프트만으로 생성된 이미지를 투명도를 가진 독립적인 편집 가능 레이어로 분리합니다. 아랍어, 영어, 러시아어, 일본어, 한국어, 태국어, 중국어, 프랑스어, 독일어, 스페인어 등 14개 언어의 텍스트를 네이티브로 렌더링하며, 최대 10장의 참조 이미지를 편집 워크플로에 사용할 수 있습니다.
설명 자료, 보고서, 학습 자료, 공정 다이어그램, 캠페인 보드, 편집 그래픽과 제품 캠페인, 사실적인 제품 비주얼, 인물 사진, 다국어 광고 현지화와 포스터 제작, 게임 캐릭터 아트, 인포그래픽 디자인, 청사진 스타일 일러스트와 분해 부품 다이어그램 같은 기술 도면에 적합합니다. 다만 도구 호출은 지원하지 않아 함수 호출이 필요한 에이전트 루프에는 unsuitable하며, 생성된 텍스트를 게시하기 전에는 맞춤법, 사실, 브랜드 요구 사항을 확인해야 합니다.
업데이트:
모델 ID
seedream-5-0-pro- 입력
- text / image
- 출력
- image
주요 특징
- 한 번에 읽을 수 있는 인포그래픽 생성
- 지정 영역만 자연스럽게 편집
- 투명도 있는 편집 가능 레이어 분리
- 14개 언어 네이티브 텍스트 렌더링
- 최대 10장 참조 이미지 지원
- 최대 2048 x 2048 해상도
제공 업체
최저가제공 업체별 API 요금을 비교하세요. 공급자를 선택하면 전체 요금과 적용 조건을 확인할 수 있습니다.
| 가동률 | ||
|---|---|---|
과거 통계는 실시간 상태 확인이 아닙니다. 데이터 누락이 장애를 뜻하지는 않습니다.
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-pro"
}'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")
PY4출력 다운로드
성공하면 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)
PYinput_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-pro",
"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 Pro?
Seedream 5.0 Pro는 ByteDance Seed가 2026년 7월에 공개한 Seedream 5.0 패밀리의 플래그십 이미지 모델입니다. 텍스트와 이미지를 입력받아 이미지를 출력하며, 한 번의 생성으로 읽을 수 있는 작은 텍스트가 포함된 고밀도 인포그래픽, 차트, 순서도, 공정 다이어그램, 타임라인을 만들 수 있습니다. 점, 바운딩 박스, 화살표, 올가미, 러프 스케치 표시로 지정한 영역만 편집하면서 나머지 프레임은 그대로 유지하고, 텍스트 프롬프트만으로 생성된 이미지를 투명도를 가진 독립적인 편집 가능 레이어로 분리합니다. 아랍어, 영어, 러시아어, 일본어, 한국어, 태국어, 중국어, 프랑스어, 독일어, 스페인어 등 14개 언어의 텍스트를 네이티브로 렌더링하며, 최대 10장의 참조 이미지를 편집 워크플로에 사용할 수 있습니다. 설명 자료, 보고서, 학습 자료, 공정 다이어그램, 캠페인 보드, 편집 그래픽과 제품 캠페인, 사실적인 제품 비주얼, 인물 사진, 다국어 광고 현지화와 포스터 제작, 게임 캐릭터 아트, 인포그래픽 디자인, 청사진 스타일 일러스트와 분해 부품 다이어그램 같은 기술 도면에 적합합니다. 다만 도구 호출은 지원하지 않아 함수 호출이 필요한 에이전트 루프에는 unsuitable하며, 생성된 텍스트를 게시하기 전에는 맞춤법, 사실, 브랜드 요구 사항을 확인해야 합니다.
사용 요금은 어떻게 계산되나요?
이용하는 제공 업체의 요금과 실제 사용량에 따라 비용이 결정됩니다. 긴 입력 등에는 다른 요금이 적용될 수 있습니다.
어떤 입력을 지원하나요?
텍스트 입력과 이미지 입력을 받아 이미지를 출력합니다. 편집 워크플로에서는 최대 10장의 참조 이미지를 사용할 수 있습니다.
이미지 해상도는 어디까지 가능한가요?
최대 2048 x 2048 픽셀까지 생성할 수 있으며, 1K, 2K 또는 검증된 사용자 지정 크기를 선택할 수 있습니다.
어떤 작업에 적합한가요?
설명 자료, 보고서, 학습 자료, 공정 다이어그램, 캠페인 보드, 편집 그래픽, 제품 캠페인, 다국어 광고 현지화, 게임 캐릭터 아트, 청사진 스타일 일러스트와 분해 부품 다이어그램에 적합합니다.
텍스트 생성은 어떤 언어를 지원하나요?
아랍어, 영어, 러시아어, 일본어, 한국어, 태국어, 중국어, 프랑스어, 독일어, 스페인어를 포함한 14개 언어를 네이티브로 렌더링합니다.
도구 호출을 지원하나요?
도구 호출은 지원하지 않으므로 함수 호출이 필요한 에이전트 루프에는 적합하지 않습니다.
관련 모델
Seedream 5.5
ByteDance Seed이미지seedream-5-5ByteDance Seed의 이미지 생성·편집 모델로, 최대 100회 반복 편집에도 원본 영역을 픽셀 단위로 보존하고 RGBA 투명 이미지를 출력합니다.
출력
image
실제 생성 비용을 기준으로 과금됩니다. 최종 금액은 청구 내역을 확인하세요.
ByteDance Seed: Seedream 5.0 Flash
ByteDance이미지seedream-5-0-flashByteDance Seed의 Seedream 5.0 Flash는 빠른 이미지 생성과 비용 효율에 초점을 맞춘 모델로, 다중 참조 입력과 정밀한 대화형 편집, 레이어 분해를 지원합니다.
출력
image
입력 이미지
$0 / 1 이미지
생성 이미지
$0.018 / 1 이미지
ByteDance Seed: Seedream 5.0 Lite
ByteDance이미지seedream-5-0-liteSeedream 5.0 Lite는 생성 전에 추론하고 실시간 검색을 결합한 ByteDance Seed의 이미지 생성·편집 모델입니다.
출력
image
입력 이미지
$0 / 1 이미지
생성 이미지
$0.035 / 1 이미지