Skip to main content

개요

Seedream은 ByteDance BytePlus ModelArk의 대표 이미지 생성 모델 시리즈로, 통합 생성-편집 아키텍처를 갖추고 있습니다: 텍스트-이미지, 단일 이미지 편집, 다중 이미지 융합, 배치 시퀀스 생성이 모두 하나의 /v1/images/generations 엔드포인트를 통해 실행되며, 달라지는 것은 매개변수뿐입니다. APIYI는 BytePlus와 전략적 파트너십을 맺고 있으며, 모든 활성 버전을 출시 당일에 통합합니다.
🎨 주요 내용: 통합 과금의 활성 버전 3종(5.0 / 4.5 / 4.0) + 4K 출력 + 융합용 참조 이미지 최대 10장 + 배치(입력 + 출력 ≤ 15) + 선도적인 텍스트 렌더링. 전자상거래 히어로 이미지, 광고 포스터, 제품 사진, 콘텐츠 제작에 이상적입니다 — 고품질과 읽을 수 있는 텍스트가 중요한 모든 곳에 적합합니다.
모든 이미지 API는 동기식입니다 — 조회할 작업 ID가 없으며, 클라이언트가 연결을 끊으면 요청은 계속 과금되지만 결과는 유실됩니다. 이 모델에는 넉넉한 타임아웃을 설정하십시오. 이미지 API 필수 요소 및 모범 사례를 참조하십시오.
어떤 Seedream입니까? APIYI는 BytePlus의 공식 해외(국제) 리소스에서 Seedream을 제공합니다 — 중국 본토 Doubao / Volcengine 버전이 아닙니다. 국제 버전은 국내 버전보다 비교적 완화된 콘텐츠 모더레이션 정책을 적용하므로 더 큰 창작 자유를 제공합니다 — 이는 이 플랫폼의 실제 강점이지만, 모더레이션이 없는 것은 아닙니다: BytePlus는 여전히 기본 내장 콘텐츠 안전 검사를 실행하며, 위반하는 프롬프트나 참조 이미지는 400/403으로 거부됩니다(거부된 요청은 과금되지 않습니다). 규정을 준수하여 사용하십시오.

텍스트-이미지 API

POST /v1/images/generations. 프롬프트로부터 1K / 2K / 3K / 4K 또는 정확한 픽셀 크기로 이미지를 생성합니다.

이미지 편집 API

동일한 엔드포인트에 image 매개변수를 사용합니다. 단일 이미지 편집, 다중 이미지 융합, 배치 시퀀스(최대 15장).

이전 버전

5.0 / 4.5 / 4.0 사양 비교, 요금 차이, 마이그레이션 가이드.

APIYI의 Seedream을 선택해야 하는 이유

BytePlus ModelArk 공식 릴레이를 대체할 수 있는 드롭인 대체재로, 안정성, 비용, 통합의 세 축에서 프로덕션 사용에 맞게 최적화되어 있습니다:

전략적 파트너십 · 안정적인 자원

BytePlus ModelArk에 대한 공식 직접 연결입니다. 요청 및 응답 동작은 상위와 동일하며 — 프로토콜 우회가 없고, 프로덕션에 안전합니다.

무제한 동시 실행 수 · 엔터프라이즈 대응

배치 생성, 다중 이미지 융합, 시퀀스 생성에 대해 선형 확장이 가능하며 — Tier식 계정 제한이 없습니다. 기본 500 RPM이며, 더 높은 쿼터는 영업팀에 문의하십시오.

동일한 가격 + 충전으로 최대 20% 할인

기본 단가는 BytePlus 공식 요금과 동일합니다. 충전 보너스와 함께 사용하면 실질 가격은 **최저 정가의 80%**까지 내려갑니다.

전 세계 무마찰 접근

해외 서버나 프록시가 필요 없습니다. 중국 본토 데이터 센터, 가정용 네트워크, 해외 노드에서 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를 사용하십시오.

전문 지원 · 엔터프라이즈 컨시어지

다중 이미지 융합, 텍스트 렌더링, 배치 에셋 제작 등 이미지 생성 활용 사례에 대한 깊은 전문성을 제공합니다. PoC부터 프로덕션 롤아웃까지 전 과정 지원합니다.

주요 기능

4K 고충실도 출력

4.0 / 4.5는 풍부한 디테일 레이어를 갖춘 네이티브 4K (4096×4096)를 지원합니다 — 포스터와 인쇄에 이상적입니다. 5.0-lite는 최대 3K까지 지원하지만 전반적으로 더 세련된 경험을 제공합니다.

생성-편집 통합

Text-to-image, 단일 이미지 편집, 다중 이미지 융합, 배치 시퀀스가 모두 하나의 엔드포인트와 하나의 파라미터 세트를 공유합니다. imagesequential_image_generation를 통해 모드를 전환합니다.

다중 이미지 융합 · 최대 10개 참조

image은 URL 배열을 받습니다. 명시적인 순서를 위해 prompt에서 「이미지 1 / 이미지 2」를 참조하십시오. sequential_image_generation: "disabled"와 함께 사용하면 주제 일관성이 유지되는 융합을 구현합니다.

텍스트 렌더링의 돌파구

4.5 릴리스는 작은 글자 가독성을 크게 개선했습니다. 포스터, 광고 문구, 제품 텍스트가 선명하고 정확하며 — 동급 최고입니다.

배치 시퀀스(최대 15개)

sequential_image_generation: "auto"max_images를 함께 사용하면 일관된 시리즈를 생성합니다 — 스토리보드, 브랜드 비주얼, 제품 시리즈에 적합합니다.

이미지당 약 15초 · 균형 잡힌 속도

단일 이미지의 일반적인 지연 시간은 약 15초이며, 4K + hd는 최대 1분까지 걸릴 수 있습니다. 500 RPM 기본 제공, 요청 시 확장 가능합니다.

유연한 크기 · 임의의 종횡비

해상도 프리셋 (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; 요청부터 전체 응답까지의 실제 경과 시간 — 요청별 정상적인 변동이 예상됩니다):
seedream-5-0-pro는 이미지당 약 2분이 일관되게 걸립니다 (모든 실행에서 110-132s로 측정되었으며, 예외는 없습니다). 이는 결함이 아니라 깊은 추론 이미지 모델의 예상되는 동작입니다. pro를 도입하기 전에 제품이 이 지연을 감당할 수 있는지 확인하십시오. 대화형 흐름(화면에서 사용자가 기다리는 방식)에는 적합하지 않으며, 대신 5.0-lite(~30s)를 사용하십시오. pro는 이미지 품질과 지시 준수가 가장 중요한 오프라인 배치 제작에 적합합니다.

API 엔드포인트

도메인 선택: 주요 엔드포인트는 api.apiyi.com입니다. vip.apiyi.com 및 다른 게이트웨이 도메인도 사용할 수 있으며, 동작은 동일합니다. BytePlus 기본 도메인을 사용할 필요는 없습니다. 예: ark.ap-southeast.bytepluses.com / ark.eu-west.bytepluses.com — APIYI는 모든 것을 OpenAI 호환 경로로 표준화합니다.

주요 파라미터 상세

size (출력 크기)

두 가지 값 계열이 있습니다 — 하나를 선택하십시오: 프리셋 등급 (모델이 종횡비를 결정합니다): 정확한 픽셀 수 (사용자 지정):
  • 총 픽셀 수 ∈ [1280×720, 4096×4096]
  • 종횡비 ∈ [1/16, 16]
  • 기본값: 2048x2048
유효한 예시: 1920x1080 (FullHD), 3840x2160 (가로 4K), 1080x1920 (휴대폰 세로), 2560x1440 (가로 2K) 유효하지 않은 예시: 5000x5000 (상한 초과), 100x1600 (종횡비가 1/16 미만)
총 픽셀이 4096×4096을 초과하는 크기는 400을 반환합니다. 극단적인 종횡비(1/16 또는 16에 가까운 경우)는 부자연스럽게 늘어날 수 있으므로, 프리셋이나 일반적인 16:9 / 9:16 / 1:1을 사용하는 것이 좋습니다.5.0 시리즈 모델은 4.x와 다른 정확한 픽셀 범위를 사용합니다(하한이 더 높고 상한이 더 낮습니다). 범위를 벗어난 크기는 오류 메시지에 유효 범위와 함께 400을 반환합니다. 측정 기준으로 5.0-lite의 하한은 대략 2560×1440입니다; 5.0-pro는 총 픽셀 4.19M에서 상한이 걸리며(최대 2048×2048; 16:9에서는 긴 변이 2720×1530 ≈ 2.7K에 도달하며 동작이 확인되었습니다) — 3K/4K 프리셋은 없습니다.

imagesequential_image_generation (모드 전환)

/v1/images/generations 엔드포인트는 텍스트-이미지와 편집/융합을 모두 지원합니다. 두 파라미터를 함께 사용해 모드를 선택합니다:
seedream-5-0-prosequential_image_generation 파라미터를 허용하지 않습니다 — 아무 값("disabled" 포함)을 전달해도 400이 반환됩니다. pro 모델로 편집/융합을 사용할 때는 image만 전달하고 해당 파라미터를 완전히 생략해야 하며, stream에도 동일하게 적용됩니다.
전체 코드 예시는 텍스트-이미지이미지 편집을 참조하십시오.

모범 사례

1

적절한 버전을 선택하십시오

  • 최고의 전반적 경험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만 지원 — 일상적인 사용에는 권장하지 않습니다)
2

사전 설정된 크기를 우선 사용하십시오

1K/2K/3K/4K는 안정적인 속도와 품질을 위해 BytePlus가 조정한 값입니다. 실제 종횡비 요구사항이 있을 때만 정확한 픽셀을 사용하십시오. 지원되는 티어는 버전별로 다르다는 점에 유의하십시오.
3

이미지를 명시적으로 참조하십시오

여러 image URL이 있는 경우, 모델이 추측하게 두지 말고 “이미지 1의 인물을 이미지 2의 장면에 넣고, 이미지 3의 색상 팔레트를 사용하십시오”처럼 명시적인 참조를 포함해 prompt를 작성하십시오.
4

배치 시퀀스 비용을 제어하십시오

sequential_image_generation: "auto" + max_images: 4 출력은 4개입니다 — 요금은 × 4입니다. 먼저 max_images: 1으로 검증한 다음 확장하십시오.
5

사용 사례에 따라 출력 형식을 선택하십시오

5.0 / 5.0-pro는 pngjpeg를 지원하고, 4.5 / 4.0은 jpeg만 지원합니다. 투명 배경이나 무손실 디테일이 필요할 때는 5.0 시리즈 + png를 사용하고, 크기에 민감한 시나리오에서는 jpeg를 사용하십시오.
6

클라이언트 타임아웃을 60초 이상으로 설정하십시오

단일 이미지는 약 15초이지만, 배치 시퀀스(4개 이미지) 또는 4K + hd는 30~60초가 걸릴 수 있습니다. **60초 클라이언트 타임아웃부터 시작하시고 UI에 진행 상태 피드백을 표시하십시오. seedream-5-0-pro는 이미지당 약 2분이 걸리므로 240초 이상의 타임아웃을 사용하십시오.
7

필요할 때 워터마크를 비활성화하십시오

watermark: false을 설정하여 BytePlus 워터마크를 제거하십시오(기본값은 버전별로 다르므로 명시적으로 설정하십시오). 상업용 에셋에는 필수입니다.

오류 코드 및 재시도

클라이언트 권장 사항:
  • 60초 요청 타임아웃으로 시작하십시오(배치 시퀀스 또는 4K + hd는 1분이 걸릴 수 있음)
  • 5xx 및 타임아웃에는 지수 백오프를 적용하십시오(권장 재시도 2회)
  • 지원 티켓용으로 x-request-id 응답 헤더를 기록하십시오

자주 묻는 질문

자세한 비교는 Historical Versions를 보십시오.
Seedream은 통합 생성-편집 아키텍처를 사용하며, 별도의 /v1/images/edits 엔드포인트가 없습니다. OpenAI의 gpt-image-2와 달리(/v1/images/edits로 multipart 업로드), Seedream은 application/json를 사용하며 이미지 URL을 배열로 image 필드에 전달합니다.장점: 프로토콜 일관성, 매개변수 재사용, 쉬운 모드 전환. 자세한 내용은 Image Editing을 보십시오.
(테스트로 검증됨). 소문자 <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이 반환됩니다).
response_format에 따라 다릅니다:
  • response_format: "url"(기본값) → data[0].url는 임시 서명된 URL이므로 <img src=...>로 바로 렌더링하십시오
  • response_format: "b64_json"data[0].b64_json일반 base64 문자열입니다(data:image/...;base64, 접두사 없음). 디코딩하여 디스크에 기록하거나, 브라우저 렌더링을 위해 접두사를 수동으로 앞에 붙이십시오.
stream: true를 통해 5.0 / 4.5 / 4.0에서 지원됩니다. streaming은 긴 prompt와 고해상도 이미지에서 특히 유용하며, 프런트엔드가 부분 결과를 점진적으로 렌더링할 수 있습니다. seedream-5-0-pro는 streaming을 지원하지 않습니다stream를 전달하면 400이 반환됩니다.
기본값은 분당 이미지 500개(분당 최대 이미지 수)이며, 버전 전반에서 동일하게 적용됩니다. 더 높은 쿼터는 영업팀에 문의하십시오.
아니요. BytePlus에는 내장된 모더레이션이 있습니다. 모더레이션 거부와 매개변수 오류는 400 / 403를 반환하며 과금되지 않습니다. 그 밖의 과금되지 않는 오류: 401(유효하지 않은 token), 429(요청 제한). 유효한 응답이 있는 성공한 generation(200)만 과금됩니다.
예, 코드 변경 없이 가능합니다. base_urlhttps://api.apiyi.com/v1로 지정하고, 확장 매개변수(image / sequential_image_generation / watermark 등)를 extra_body를 통해 전달하십시오:
생성된 이미지는 상업적 및 비상업적으로 사용할 수 있습니다. 자세한 내용은 BytePlus 이용 약관을 보십시오.
seedream-5-0 / seedream-5-0-propng 출력을 지원하며, “투명 배경, alpha 채널”이라고 프롬프트하면 투명 배경을 생성할 수 있습니다. seedream-4-5 / 4-0jpeg 출력만 제공하며 투명성을 지원하지 않습니다 — 배경 제거는 후처리로 직접 수행하십시오.
아니요. /v1/images/generations는 동기식입니다. 일단 제출되면 요청은 완료될 때까지 실행됩니다. 클라이언트가 연결을 끊어도 서버는 처리를 완료하고 과금합니다. 클라이언트 타임아웃을 설정하고 연결 해제가 비용을 절감한다고 가정하지 마십시오.

관련 문서

Seedream은 APIYI와 BytePlus ModelArk의 전략적 파트너십을 통해 제공됩니다. 세 가지 버전은 하나의 통합, 과금, 인증 경로를 공유하므로 필요에 따라 선택하십시오. 질문이나 피드백이 있으면 콘솔에서 티켓을 제출하십시오.