개요
Seedream은 ByteDance BytePlus ModelArk의 대표 이미지 생성 모델 시리즈로, 통합 생성-편집 아키텍처를 갖추고 있습니다: 텍스트-이미지, 단일 이미지 편집, 다중 이미지 융합, 배치 시퀀스 생성이 모두 하나의/v1/images/generations 엔드포인트를 통해 실행되며, 달라지는 것은 매개변수뿐입니다. APIYI는 BytePlus와 전략적 파트너십을 맺고 있으며, 모든 활성 버전을 출시 당일에 통합합니다.
텍스트-이미지 API
POST /v1/images/generations. 프롬프트로부터 1K / 2K / 3K / 4K 또는 정확한 픽셀 크기로 이미지를 생성합니다.이미지 편집 API
image 매개변수를 사용합니다. 단일 이미지 편집, 다중 이미지 융합, 배치 시퀀스(최대 15장).이전 버전
APIYI의 Seedream을 선택해야 하는 이유
BytePlus ModelArk 공식 릴레이를 대체할 수 있는 드롭인 대체재로, 안정성, 비용, 통합의 세 축에서 프로덕션 사용에 맞게 최적화되어 있습니다:전략적 파트너십 · 안정적인 자원
무제한 동시 실행 수 · 엔터프라이즈 대응
동일한 가격 + 충전으로 최대 20% 할인
전 세계 무마찰 접근
api.apiyi.com에 직접 연결됩니다. BytePlus ap-southeast-1 / eu-west-1 리전에 대한 라우팅을 따로 설정할 필요가 없습니다.OpenAI 호환 · 코드 변경 불필요
/v1/images/generations 경로는 OpenAI와 동일합니다. OpenAI SDK의 base_url를 APIYI로 지정하고 API를 그대로 호출하면 됩니다. 확장 파라미터(image / sequential_image_generation 등)는 extra_body를 통해 전달하십시오. OpenAI의 n 매개변수는 상위에서 지원되지 않습니다(조용히 무시되며 — 여전히 이미지 1장을 받습니다). 여러 이미지 출력을 하려면 sequential_image_generation를 사용하십시오.전문 지원 · 엔터프라이즈 컨시어지
주요 기능
4K 고충실도 출력
생성-편집 통합
image와 sequential_image_generation를 통해 모드를 전환합니다.다중 이미지 융합 · 최대 10개 참조
image은 URL 배열을 받습니다. 명시적인 순서를 위해 prompt에서 「이미지 1 / 이미지 2」를 참조하십시오. sequential_image_generation: "disabled"와 함께 사용하면 주제 일관성이 유지되는 융합을 구현합니다.텍스트 렌더링의 돌파구
배치 시퀀스(최대 15개)
sequential_image_generation: "auto"와 max_images를 함께 사용하면 일관된 시리즈를 생성합니다 — 스토리보드, 브랜드 비주얼, 제품 시리즈에 적합합니다.이미지당 약 15초 · 균형 잡힌 속도
유연한 크기 · 임의의 종횡비
1K/2K/3K/4K) 또는 정확한 픽셀 지정. 총 픽셀 ∈ [1280×720, 4096×4096], 종횡비 ∈ [1/16, 16].즉시 사용 가능한 OpenAI SDK
base_url=https://api.apiyi.com/v1을 설정하고 공식 OpenAI SDK로 호출합니다. 확장 파라미터는 extra_body를 통해 전달됩니다. 마이그레이션 시 코드 변경이 전혀 필요 없습니다.가격
이미지당 과금이며, BytePlus 공식과 동일한 가격입니다. 충전 보너스로 실효 단가가 더 낮아집니다.- prompt 길이나 fusion mode와 관계없이 생성된 이미지 1장당 과금됩니다
seedream-5-0-pro는 요청당 고정 $0.12로 과금됩니다(요청당 이미지 1장; 배치 시퀀스는 지원하지 않습니다). 공식적으로 이 모델은 두 개의 출력 픽셀 요금 구간(≤2.36M px에는 하나의 가격, >2.36M px에는 다른 가격)과 첫 번째 이후의 참고 이미지마다 이미지당 요금을 사용하지만, APIYI는 이를 요청당 고정 가격으로 단순화합니다 — 구간이 없고, 입력 이미지 요금이 포함됩니다. 이 모델에는 어떠한 공식 할인도 전혀 없으며, APIYI는 이를 공급 보장 기준으로 가격 책정합니다 — 충전 보너스와 세금 비용을 반영하면 사실상 마진이 없으며 — 가격 변경 시에는 사전에 공지합니다sequential_image_generation: "auto"mode에서는 실제 출력 개수 기준으로 과금됩니다(예:max_images: 4출력 4개 → 4개 과금)- 실패한 요청(4xx / 모더레이션에 의해 차단됨)은 과금되지 않습니다
- 무료 체험: 최초 온보딩 시 200장의 무료 이미지(BytePlus 제공)
- 충전 보너스 세부 사항은 충전 프로모션을 참고하십시오
기술 사양
생성 시간 비교
버전별 단일 요청 지연 시간 측정값입니다(2026-07에 측정, UTC+8; 요청부터 전체 응답까지의 실제 경과 시간 — 요청별 정상적인 변동이 예상됩니다):API 엔드포인트
주요 파라미터 상세
size (출력 크기)
두 가지 값 계열이 있습니다 — 하나를 선택하십시오:
프리셋 등급 (모델이 종횡비를 결정합니다):
- 총 픽셀 수 ∈ [1280×720, 4096×4096]
- 종횡비 ∈ [1/16, 16]
- 기본값:
2048x2048
1920x1080 (FullHD), 3840x2160 (가로 4K), 1080x1920 (휴대폰 세로), 2560x1440 (가로 2K)
유효하지 않은 예시: 5000x5000 (상한 초과), 100x1600 (종횡비가 1/16 미만)
image 및 sequential_image_generation (모드 전환)
/v1/images/generations 엔드포인트는 텍스트-이미지와 편집/융합을 모두 지원합니다. 두 파라미터를 함께 사용해 모드를 선택합니다:
모범 사례
적절한 버전을 선택하십시오
- 최고의 전반적 경험 →
seedream-5-0-260128(가장 많은 기능을 제공하지만 3K 제한) - 4K + 강력한 텍스트 렌더링 →
seedream-4-5-251128(4K + 텍스트 돌파) - 4K + 최저 가격 →
seedream-4-0-250828(가장 저렴한 4K) - 최고 수준의 이미지 품질 / 복잡한 지시사항(전문 작업) →
seedream-5-0-pro-260628($0.12/요청, 이미지당 약 2분, 1K/2K만 지원 — 일상적인 사용에는 권장하지 않습니다)
사전 설정된 크기를 우선 사용하십시오
1K/2K/3K/4K는 안정적인 속도와 품질을 위해 BytePlus가 조정한 값입니다. 실제 종횡비 요구사항이 있을 때만 정확한 픽셀을 사용하십시오. 지원되는 티어는 버전별로 다르다는 점에 유의하십시오.이미지를 명시적으로 참조하십시오
image URL이 있는 경우, 모델이 추측하게 두지 말고 “이미지 1의 인물을 이미지 2의 장면에 넣고, 이미지 3의 색상 팔레트를 사용하십시오”처럼 명시적인 참조를 포함해 prompt를 작성하십시오.배치 시퀀스 비용을 제어하십시오
sequential_image_generation: "auto" + max_images: 4 출력은 4개입니다 — 요금은 × 4입니다. 먼저 max_images: 1으로 검증한 다음 확장하십시오.사용 사례에 따라 출력 형식을 선택하십시오
png 및 jpeg를 지원하고, 4.5 / 4.0은 jpeg만 지원합니다. 투명 배경이나 무손실 디테일이 필요할 때는 5.0 시리즈 + png를 사용하고, 크기에 민감한 시나리오에서는 jpeg를 사용하십시오.클라이언트 타임아웃을 60초 이상으로 설정하십시오
seedream-5-0-pro는 이미지당 약 2분이 걸리므로 240초 이상의 타임아웃을 사용하십시오.필요할 때 워터마크를 비활성화하십시오
watermark: false을 설정하여 BytePlus 워터마크를 제거하십시오(기본값은 버전별로 다르므로 명시적으로 설정하십시오). 상업용 에셋에는 필수입니다.오류 코드 및 재시도
- 60초 요청 타임아웃으로 시작하십시오(배치 시퀀스 또는 4K + hd는 1분이 걸릴 수 있음)
- 5xx 및 타임아웃에는 지수 백오프를 적용하십시오(권장 재시도 2회)
- 지원 티켓용으로
x-request-id응답 헤더를 기록하십시오
자주 묻는 질문
5.0 Pro / 5.0 / 4.5 / 4.0 — 무엇을 선택해야 합니까?
5.0 Pro / 5.0 / 4.5 / 4.0 — 무엇을 선택해야 합니까?
이미지 편집도 generations 엔드포인트를 사용하는 이유는 무엇입니까?
이미지 편집도 generations 엔드포인트를 사용하는 이유는 무엇입니까?
/v1/images/edits 엔드포인트가 없습니다. OpenAI의 gpt-image-2와 달리(/v1/images/edits로 multipart 업로드), Seedream은 application/json를 사용하며 이미지 URL을 배열로 image 필드에 전달합니다.장점: 프로토콜 일관성, 매개변수 재사용, 쉬운 모드 전환. 자세한 내용은 Image Editing을 보십시오.image 필드는 base64를 허용합니까?
image 필드는 base64를 허용합니까?
<format>가 포함된 data URI인 data:image/<format>;base64,<base64 string>를 사용하십시오. 예: data:image/jpeg;base64,.... URL과 base64 항목은 같은 배열에서 혼합할 수 있습니다. 큰 로컬 이미지는 요청 본문을 작게 유지하기 위해 이미지 호스팅에 업로드한 뒤 URL을 전달하는 편이 여전히 더 좋습니다.다중 이미지 융합 제한? 배치 시퀀스 제한?
다중 이미지 융합 제한? 배치 시퀀스 제한?
- 다중 이미지 융합(
image배열): 4.5 / 5.0-pro는 명시적으로 최대 10개를 지원합니다. 5.0 / 4.0도 다중 이미지를 지원하지만, 명시적인 상한은 문서화되어 있지 않습니다. - 배치 시퀀스(
max_images): 전역 규칙 입력 참조 + 출력 ≤ 15로 제한됩니다. 융합과 시퀀스를 함께 사용할 때는 총합을 계산해야 합니다. 참고로 5.0-pro는 배치 시퀀스를 지원하지 않습니다(sequential_image_generation를 전달하면 400이 반환됩니다).
b64_json에 data:image 접두사가 필요합니까?
b64_json에 data:image 접두사가 필요합니까?
response_format에 따라 다릅니다:response_format: "url"(기본값) →data[0].url는 임시 서명된 URL이므로<img src=...>로 바로 렌더링하십시오response_format: "b64_json"→data[0].b64_json는 일반 base64 문자열입니다(data:image/...;base64,접두사 없음). 디코딩하여 디스크에 기록하거나, 브라우저 렌더링을 위해 접두사를 수동으로 앞에 붙이십시오.
streaming 출력이 지원됩니까?
streaming 출력이 지원됩니까?
stream: true를 통해 5.0 / 4.5 / 4.0에서 지원됩니다. streaming은 긴 prompt와 고해상도 이미지에서 특히 유용하며, 프런트엔드가 부분 결과를 점진적으로 렌더링할 수 있습니다. seedream-5-0-pro는 streaming을 지원하지 않습니다 — stream를 전달하면 400이 반환됩니다.요청 제한은?
요청 제한은?
실패한 요청에도 과금됩니까?
실패한 요청에도 과금됩니까?
400 / 403를 반환하며 과금되지 않습니다. 그 밖의 과금되지 않는 오류: 401(유효하지 않은 token), 429(요청 제한). 유효한 응답이 있는 성공한 generation(200)만 과금됩니다.공식 OpenAI SDK를 사용할 수 있습니까?
공식 OpenAI SDK를 사용할 수 있습니까?
base_url를 https://api.apiyi.com/v1로 지정하고, 확장 매개변수(image / sequential_image_generation / watermark 등)를 extra_body를 통해 전달하십시오:생성된 이미지의 소유권은 누구에게 있습니까?
생성된 이미지의 소유권은 누구에게 있습니까?
투명 배경을 지원합니까?
투명 배경을 지원합니까?
seedream-5-0 / seedream-5-0-pro는 png 출력을 지원하며, “투명 배경, alpha 채널”이라고 프롬프트하면 투명 배경을 생성할 수 있습니다. seedream-4-5 / 4-0는 jpeg 출력만 제공하며 투명성을 지원하지 않습니다 — 배경 제거는 후처리로 직접 수행하십시오.진행 중인 생성을 취소할 수 있습니까?
진행 중인 생성을 취소할 수 있습니까?
/v1/images/generations는 동기식입니다. 일단 제출되면 요청은 완료될 때까지 실행됩니다. 클라이언트가 연결을 끊어도 서버는 처리를 완료하고 과금합니다. 클라이언트 타임아웃을 설정하고 연결 해제가 비용을 절감한다고 가정하지 마십시오.관련 문서
- Text-to-Image Playground — 다섯 개의 언어 코드 샘플이 있는
POST /v1/images/generations - Image Editing Playground —
image+sequential_image_generation패턴 - Historical Versions — 5.0 / 4.5 / 4.0 비교 및 마이그레이션
- API Manual — 일반적인 호출 가이드
- Image Generation Sandbox — 온라인에서 체험해 보십시오
- BytePlus 공식 문서:
docs.byteplus.com/en/docs/ModelArk/1824121— Seedream 4.0-5.0 튜토리얼