BytePlus ModelArk · Seedream Image Generation

이미지 생성 모델 제약요건

Seedream 5.0 Pro · 5.0 Lite · 4.5 모델의 입력 이미지 포맷 · 해상도 · 출력 크기 · 파라미터 지원 여부를 정리한 문서입니다. (개발사 전달용)

↗ Image Generation API Docs
00

모델별 생성 능력

3개 모델
모델 ID로 호출 — 단일 엔드포인트 공유: POST /api/v3/images/generations
✦ SEEDREAM 5.0 PRO — 고품질 단일 생성
한 번 요청에 이미지 1장만 생성.
대신 인터랙티브 편집 지원 (좌표·박스·화살표로 특정 영역 수정) — Lite·4.5에는 없는 기능.
단일 최고품질 결과물이 목적일 때 사용.
◈ SEEDREAM 5.0 LITE · 4.5 — 배치 생성 특화
한 번 요청에 이미지 최대 15장 생성 (sequential image generation).
출력 해상도도 Pro보다 높음 (Lite: 최대 4K, 4.5: 최대 4K).
다양한 시안·변형안을 한 번에 뽑을 때 사용.
생성 방식 Seedream 5.0 Pro Seedream 5.0 Lite Seedream 4.5
T2I — 텍스트 → 이미지 단일
I2I — 참조 이미지 1장 + 텍스트
Multi-I2I — 참조 이미지 복수 + 텍스트 ✅ (2-10장) ✅ (2-14장) ✅ (2-14장)
배치 생성 (sequential image generation)
1 요청 → 여러 장 출력
— 단일 생성 전용 모델
파라미터 전달 시 에러
✅ 최대 15장 ✅ 최대 15장
인터랙티브 편집 (좌표·박스·화살표 지정)
Pro 전용 고급 기능
Pro 전용 — 미지원 — 미지원
스트리밍 출력 (stream)
생성되는 즉시 순차 반환
— 단일 생성 전용 모델
파라미터 전달 시 에러
구현 주의 (5.0 Pro): Pro는 단일 생성 전용 설계이므로 sequential_image_generation · stream 파라미터를 요청 body에 포함하면 API 에러가 발생합니다. 모델 분기 시 해당 파라미터를 반드시 제거해야 합니다.
01

입력 이미지 요건 (3개 모델 공통)

참조 이미지 기준
Base64 또는 접근 가능한 URL 모두 지원 — seedream-3-0-t2i는 이미지 입력 자체 미지원
항목제약
입력 방식 URL: 외부에서 접근 가능한 이미지 URL
Base64: data:image/<format>;base64,<data> 형식 (<format>은 소문자)
지원 포맷 공통 jpeg, png
5.0 Pro · 5.0 Lite · 4.5 jpeg, png, webp, bmp, tiff, gif, heic, heif
가로세로 비율 (W/H) [1/16, 16]
가로·세로 최소 크기 (px) > 14px (가로, 세로 각각)
전체 픽셀 (W×H) 최대 6,000 × 6,000 = 36,000,000 px
파일 용량 이미지 1장당 30 MB 이하
최대 참조 이미지 수
입력 기준 (단일 요청)
5.0 Pro 최대 10장
5.0 Lite · 4.5 최대 14장
⚠ Lite · 4.5 배치 모드 시: 참조 이미지 수 + 출력 이미지 수 ≤ 15
예) 참조 14장 → 출력 최대 1장 / 참조 0장 → 출력 최대 15장
02

출력 이미지 크기 (size 파라미터)

모델별 상이
Method 1 (해상도 레이블)과 Method 2 (픽셀 직접 지정) 중 하나만 사용 — 동시 사용 불가
항목 Seedream 5.0 Pro Seedream 5.0 Lite Seedream 4.5
Method 1
해상도 레이블
1K, 2K
기본값: 2K
2K, 3K, 4K 2K, 4K
Method 2
픽셀 직접 지정
921,600 ~ 4,624,220
(1280×720 ~ 약 2048×2256)
3,686,400 ~ 16,777,216
(2560×1440 ~ 4096×4096)
기본값: 2048×2048
3,686,400 ~ 16,777,216
(2560×1440 ~ 4096×4096)
기본값: 2048×2048
Aspect ratio (Method 2) [1/16, 16] (공통)
Method 1 — 대표 해상도 픽셀 값
해상도 비율 Seedream 5.0 Pro (1K) Seedream 5.0 Pro (2K) 5.0 Lite · 4.5 (2K) 5.0 Lite (3K) 5.0 Lite · 4.5 (4K)
1:1정방형 1024×10242048×2048 2048×20483072×30724096×4096
16:9가로 1424×8002816×1584 *Pro없음 2848×16004096×23045504×3040
9:16세로 800×14241584×2816 *Pro없음 1600×28482304×40963040×5504
4:3가로 1152×8642368×1776 2304×17283456×25924704×3520
3:4세로 864×11521776×2368 1728×23042592×34563520×4704
21:9와이드 1568×6723136×1344 3136×13444704×20166240×2656
Method 2 주의: 총 픽셀 범위와 Aspect ratio 조건을 동시에 만족해야 합니다. 예: 1500×1500 = 2,250,000px → 5.0 Lite/4.5 최소(3,686,400) 미달로 거부됨.
03

파라미터 지원 여부 비교

모델별 상이
미지원 모델에 파라미터를 전달하면 에러 발생
파라미터 설명 Seedream 5.0 Pro Seedream 5.0 Lite Seedream 4.5
image 참조 이미지 입력
입력 이미지 최대 수
✅ 최대 10장 ✅ 최대 14장 ✅ 최대 14장
sequential_image_generation 배치 생성 모드
auto / disabled
— 단일 생성 전용
전달 시 에러
✅ auto / disabled ✅ auto / disabled
sequential_image_generation_options 출력 이미지 수 설정
max_images 기본값 15, 범위 [1~15]
※ 참조 입력 수 + 출력 수 ≤ 15
— 단일 생성 전용
전달 시 에러
stream 스트리밍 출력
생성 즉시 순차 반환
— 단일 생성 전용
전달 시 에러
output_format 출력 포맷 (png / jpeg) ✅ png · jpeg ✅ png · jpeg ❌ (jpeg만)
response_format url 또는 b64_json
watermark 워터마크 (기본값: true)
optimize_prompt_options 프롬프트 최적화 (standard / fast) ✅ standard · fast ✅ standard만 ✅ standard만
guidance_scale 프롬프트 준수도 [1-10] ❌ 미지원 ❌ 미지원 ❌ 미지원
seed 랜덤 시드 [-1 ~ 2147483647] ❌ 미지원 ❌ 미지원 ❌ 미지원
optimize_prompt_options.mode: fast 모드는 5.0 Pro만 지원합니다. 5.0 Lite · 4.5는 standard만 사용 가능합니다.
04

공통 제약

요청/응답 기준
항목제약
API 엔드포인트 POST https://ark.ap-southeast.bytepluses.com/api/v3/images/generations
eu-west-1 리전: https://ark.eu-west.bytepluses.com/api/v3
응답 URL 유효기간 생성 후 24시간 — 만료 전 이미지 저장 필수
응답 형식 url: 이미지 다운로드 링크 (기본값)
b64_json: JSON 내 Base64 인코딩 이미지 데이터
토큰 계산 공식 output_tokens = sum(width × height) / 256 → 정수 반올림
예: 2048×2048 = 4,194,304 / 256 = 16,384 tokens
프롬프트 권장 길이 영문 600단어 이하 — 초과 시 주요 요소에만 집중되어 세부 묘사 누락 가능
배치 생성 제약
5.0 Lite · 4.5 전용
입력 참조 이미지 수 + 출력 이미지 수 ≤ 15
참조 0장(T2I) → 출력 최대 15장
참조 1장(I2I) → 출력 최대 14장
참조 14장(Multi-I2I) → 출력 최대 1장
워터마크 기본값 watermark: true — 우측 하단에 "AI generated" 표시. 제거 시 false
05

실무 체크포인트

📄 관련 공식 문서 (Image Generation API) https://docs.byteplus.com/en/docs/ModelArk/1541523