byteplus/seedream-5-0-pro-260628의 API 레퍼런스입니다. Comfy Router가 BytePlus에서 제공합니다.
입력: 텍스트, 이미지 · 출력: 이미지
빠른 시작
Comfy 워크스페이스에서 키를 생성하고COMFY_API_KEY로 내보내세요. Python 및 TypeScript 스니펫은 Comfy SDK(pip install comfy-sdk, npm install @comfyorg/sdk)를 사용하며, cURL 스니펫은 원시 HTTP를 통한 동일한 호출입니다.
모델 ID: byteplus/seedream-5-0-pro-260628
엔드포인트: POST https://api.comfy.org/v2/models/byteplus/seedream-5-0-pro-260628
- 결과 기다리기
- 대기열에 넣고 나중에 수집
동일한 본문을
POST https://api.comfy.org/v2/models/byteplus/seedream-5-0-pro-260628/requests 로 전송합니다. Router는 실행이 접수되는 즉시 201 과 request_id 로 응답하며, 결과는 준비가 완료되면 이 프로세스나 다른 프로세스에서 수집할 수 있습니다. 상태, 취소, 수집 방법은 대기열 전송에서 자세히 다룹니다.스키마
입력
생성된 이미지에 투명 배경(알파 채널)이 있는지 여부를 제어합니다. seedream-5.0-pro, 5.0-flash 및 자체 스키마에 이 항목이 문서화된 최신 Seedream 모델에서 지원됩니다.
auto: 모델이 프롬프트와 output_format을 기반으로 결정합니다. output_format이 jpeg이면 출력은 항상 불투명합니다.
transparent: 투명 배경을 가진 RGBA 이미지를 출력합니다. output_format이 jpeg이면 오류를 반환합니다.
opaque: 불투명 배경을 가진 RGB 이미지를 출력합니다. seedream-5.0-pro의 기본값입니다.
seedream-5.0-pro는 알파 채널이 있는 png 입력 이미지 한 장을 사용하는 이미지 기반 이미지 생성에서만 투명 출력을 지원합니다.
레이어 분리 시나리오에서는 지원되지 않습니다. layer_decomposition을 활성화한 상태로 전달하면 오류를 반환합니다.가능한 값:
auto, transparent, opaque출력 이미지가 입력 프롬프트에 얼마나 밀접하게 부합하는지 제어합니다. 범위는 [1, 10]입니다. 값이 클수록 프롬프트 준수가 강해집니다. seedream-5.0-pro, 5.0-lite, 4.5 및 4.0에서는 지원되지 않습니다.범위:
1 ~ 10형식: float편집할 이미지 또는 이미지들로, 접근 가능한 URL 또는 data-URI 접두사가 붙은 Base64 페이로드입니다. 참조 이미지 상한이 이 모델에서는 14가 아니라 10이라는 점을 제외하면 공유 Seedream 필드와 동일합니다.
레이어 분리 활성화 여부를 제어합니다. seedream-5.0-pro, 5.0-flash 및 5.5만 이 매개변수를 지원합니다.
true: 레이어 분리 모드입니다. 모델이 단일 입력 이미지를 하나의 기본 이미지와 여러 레이어(최대 16개, seedream-5.5에서는 최대 99개)로 분해하고, 적재 순서(z_index), 바운딩 박스(bounding_box), 이름(name), 설명(description)을 포함하여 생성된 각 레이어의 위치 및 콘텐츠 정보를 반환합니다.
false: 표준 이미지 생성 모드이며, 레이어 분리를 수행하지 않습니다.
레이어 분리 모드 관련 참고 사항: 단일 입력 이미지만 지원됩니다(여러 이미지를 전달하면 오류 반환). 어느 한 레이어라도 생성에 실패하면 요청 전체가 실패합니다. 부분 성공은 지원되지 않습니다. 최대 17개의 이미지가 반환됩니다(기본 이미지 1개 + 레이어 16개). seedream-5.5는 최대 layer_decomposition_options.max_images 개의 이미지를 반환합니다(기본 이미지 1개 + 최대 99개 레이어). sequential_image_generation, sequential_image_generation_options, tools 및 stream을 전달하면 오류를 반환합니다.
이 요청이 반환하는 최대 총 이미지 수로, 기본 이미지와 레이어를 합한 값입니다. 범위: [2, 100]. 프롬프트에서 이미지를 어떻게 분할할지 지정하지 않은 경우, 모델은 max_images와 입력 이미지의 복잡도를 바탕으로 레이어를 계획하며, 값이 클수록 보통 더 세밀한 레이어가 만들어집니다.범위:
2 ~ 100모델 식별자입니다. 지원 모델: seedream-4-0-250828, seedream-4-5-251128, seedream-5-0-260128, seedream-5-0-pro-260628, seedream-5-0-flash-260915, seedream-5-5-261028. POST /proxy/byteplus/api/v3/images/generations에 대한 직접 v1 호출은 반드시 이를 제공해야 합니다. 프록시는 다른 값이나 누락된 값을 400으로 거부합니다. 이 스키마의
required 목록에 없는 이유는 Comfy Router가 /v2/models/byteplus/{model}의 {model} 경로 세그먼트에서 이를 채우기 때문에 Router 호출자는 이를 생략하기 때문입니다.프롬프트 최적화 기능의 설정입니다. seedream-5.0-pro/5.0-lite/4.5/5.5(standard 모드만 지원하며, seedream-5.5는 fast에 대해 오류를 반환)와 seedream-4.0만 이 매개변수를 지원합니다.
프롬프트 최적화 기능의 모드를 설정합니다. standard = 더 높은 품질, 더 긴 생성 시간. fast = 더 빠르지만 평균 수준의 품질.가능한 값:
standard, fast출력 이미지의 형식을 지정합니다. seedream-5.0-pro, 5.0-flash, 5.0-lite 및 5.5만 이 매개변수를 지원합니다. seedream-5.5의 기본값은 png입니다. 레이어 분리 시나리오에서 output_format은 기본 이미지의 형식만 제어하며, 모든 레이어는 항상 png로 출력됩니다.가능한 값:
png, jpeg이미지 생성 또는 변환을 위한 텍스트 설명입니다.
레이어 분리 시나리오(seedream-5.0-pro, 5.0-flash 또는 layer_decomposition이 활성화된 5.5)에서는 선택 사항입니다. 프롬프트를 제공하면 모델이 프롬프트 의도에 따라 지정한 요소를 인식하고 분리하며, 프롬프트를 제공하지 않으면 모델이 이미지의 모든 주요 요소를 자동으로 감지하여 독립적인 레이어로 분리합니다.
이미지 생성의 무작위성을 제어하는 시드입니다. 범위: [-1, 2147483647]. 지정하지 않으면 시드가 자동으로 생성됩니다. 동일한 출력을 재현하려면 동일한 시드 값을 사용하세요.범위:
-1 ~ 2147483647배치 생성 기능을 비활성화할지 여부를 제어합니다. 이 매개변수는 seedream-5.0-lite, 4.5 및 4.0에서만 지원됩니다(seedream-5.0-pro, 5.0-flash 또는 5.5에서는 지원되지 않음). 유효한 값:
auto: 자동 모드에서는 모델이 사용자의 프롬프트를 기반으로 여러 이미지를 반환할지 여부와 포함할 이미지 수를 자동으로 결정합니다.
disabled: 배치 생성 기능을 비활성화합니다. 모델은 이미지를 하나만 생성합니다.가능한 값:
auto, disabled이 파라미터는 seedream-5.0-lite, 4.5, 4.0에서만 지원됩니다(seedream-5.0-pro, 5.0-flash, 5.5에서는 지원되지 않음).
배치 이미지 생성 기능에 대한 설정입니다. 이 파라미터는 sequential_image_generation이 auto로 설정된 경우에만 적용됩니다.
“seedream-4-0-250828”: 생성할 이미지의 사양을 설정합니다. 두 가지 방법을 사용할 수 있지만 함께 사용할 수는 없습니다.
방법 1 | 해상도를 지정합니다. 선택 가능한 값: 1K, 2K, 4K
방법 2 | 너비와 높이를 픽셀 단위로 지정합니다. 기본값: 2048x2048, 총 픽셀: [1024x1024, 4096x4096], 가로세로 비율: [1/16, 16]
“seedream-4-5-251128”: 두 가지 방법을 사용할 수 있습니다.
방법 1 | 해상도를 지정합니다. 선택 가능한 값: 2K, 4K
방법 2 | 너비와 높이를 픽셀 단위로 지정합니다. 기본값: 2048x2048, 총 픽셀: [2560x1440, 4096x4096], 가로세로 비율: [1/16, 16]
“seedream-5-0-260128”: 두 가지 방법을 사용할 수 있습니다.
방법 1 | 해상도를 지정합니다. 선택 가능한 값: 2K, 3K
방법 2 | 너비와 높이를 픽셀 단위로 지정합니다. 기본값: 2048x2048, 총 픽셀: [2560x1440, ~3072x3072], 가로세로 비율: [1/16, 16]
“seedream-5-0-pro-260628”: 두 가지 방법을 사용할 수 있습니다(함께 사용할 수 없음).
방법 1 | 해상도를 지정하고 프롬프트에 이미지의 가로세로 비율, 형태 또는 용도를 설명합니다. 모델이 최종 크기를 결정합니다. 선택 가능한 값: 1K, 2K
방법 2 | 너비와 높이를 픽셀 단위로 지정합니다. 기본값: 1024x1024, 총 픽셀: [1024x1024 (1048576), 2048x2048 (4194304)], 가로세로 비율: [1/16, 16]
“seedream-5-0-flash-260915”: 두 가지 방법을 사용할 수 있습니다(함께 사용할 수 없음).
방법 1 | 해상도를 지정하고 프롬프트에 이미지의 가로세로 비율, 형태 또는 용도를 설명합니다. 모델이 최종 크기를 결정합니다. 선택 가능한 값: 1K, 1.5K, 2K. 기본값: 2K
방법 2 | 너비와 높이를 픽셀 단위로 지정합니다. 총 픽셀: [1280x720 (921600), 2048x2048x1.1025 (4624220)], 가로세로 비율: [1/16, 16]
“seedream-5-5-261028”: 두 가지 방법을 사용할 수 있습니다(함께 사용할 수 없음).
방법 1 | 해상도를 지정합니다. 선택 가능한 값: 1K, 1.5K, 2K. 기본값: 2K
방법 2 | 너비와 높이를 픽셀 단위로 지정합니다. 총 픽셀: [1280x720 (921600), 2048x2048x1.1025 (4624220)], 가로세로 비율: [1/16, 16]
“seedream-5-0-pro-260628”, “seedream-5-0-flash-260915”, “seedream-5-5-261028”에서 layer_decomposition이 활성화된 경우: 해상도 수준 방법만 지원됩니다. 선택 가능한 값: 1K, 1.5K, 2K, auto. 기본값: auto.
기본 이미지는 원본 입력 이미지의 가로세로 비율로 지정된 해상도에서 출력되며, 각 레이어는 원본 이미지에서 가졌던 가로세로 비율을 유지하면서 지정된 해상도에 가깝게 출력됩니다.
auto: 입력 이미지의 크기와 가로세로 비율을 기준으로 출력합니다. [1280x720, ~2048x2048] 범위의 입력은 원본 입력 크기로 출력되고, 1K보다 작은 입력은 1K로, 2K보다 큰 입력은 2K로 출력됩니다.
Comfy Router는 완전한 JSON 결과를 캡처하기 때문에 명시적으로 전달된 stream 플래그를 false로 확정합니다. v1 프록시에서 이 필드는 스트리밍 출력 모드를 활성화할지 여부를 제어합니다. 이 파라미터는 seedream-5.0-lite, 4.5, 4.0에서만 지원됩니다(seedream-5.0-pro, 5.0-flash, 5.5에서는 지원되지 않음). false = 모든 출력 이미지가 한 번에 반환됩니다. true = 각 출력 이미지가 생성된 직후 즉시 반환됩니다.
생성된 이미지에 워터마크를 추가할지 여부를 지정합니다. false = 워터마크 없음, true = ‘AI generated’ 라벨이 있는 워터마크 추가
GET /v2/models/byteplus/seedream-5-0-pro-260628/openapi.json에서 Router가 제공하는 스키마를 바탕으로 생성되었으며, 이는 요청이 공급자에 도달하기 전에 호출을 검증하는 데 사용하는 것과 동일한 문서입니다.
출력
생성된 이미지에 대한 정보를 포함합니다.
레이어 분리 시나리오에서 배열의 첫 번째 요소는 기본 이미지(z_index=0)이며, 이후 요소는 z_index가 증가하는 순서로 정렬된 레이어입니다.
이미지가 실제로 가지는 배경 유형으로, transparent 또는 opaque입니다. 레이어 분리 시나리오에서 기본 이미지는 항상 opaque이고 모든 레이어는 transparent입니다. 이 필드는 seedream-5.5만 반환합니다.
현재 레이어가 기본 이미지 내에서 차지하는 영역의 바운딩 박스 정보입니다. 이 필드는 레이어만 반환하며, 기본 이미지는 캔버스 전체를 차지하므로 bounding_box를 반환하지 않습니다. layer_decomposition이 true인 경우에만 반환됩니다.
레이어 바운딩 박스의 절대 픽셀 좌표로, 왼쪽 위 모서리가 (0, 0)인 출력 기본 이미지의 좌표계를 기준으로 합니다. 좌표 형식: [left, top, right, bottom].
레이어 바운딩 박스의 천분율(per-mille) 양자화(정규화) 좌표로, 기본 이미지 크기를 기준으로 [0, 1000]의 이산 정수 범위에 비례적으로 매핑되며 최대 1000에서 잘립니다. 좌표 형식: [left, top, right, bottom].
현재 분리된 요소에 대한 상세 설명으로, name보다 풍부한 레이어 특성(색상, 상태, 재질 등)을 제공합니다. 이 필드는 레이어만 반환하며 기본 이미지는 반환하지 않습니다. layer_decomposition이 true인 경우에만 반환됩니다.
현재 분리된 요소의 이름/레이블로, 분리된 피사체의 특성에 따라 모델이 자동으로 생성합니다. 이 필드는 레이어만 반환하며 기본 이미지는 반환하지 않습니다. layer_decomposition이 true인 경우에만 반환됩니다.
이미지의 너비와 높이(픽셀)로, 형식은 <width>x<height>입니다. 이 파라미터는 seedream-5.0-pro, 5.0-lite, 5.5, 4.5, 4.0만 지원합니다.
레이어의 적층 순서로, 아래에서 위로 갈수록 증가합니다. 0은 가장 아래 레이어(기본 이미지)이며 값이 클수록 위에 위치합니다. 레이어를 올바른 적층 순서로 다시 합쳐 완전한 이미지로 재구성할 때 사용합니다. layer_decomposition이 true인 경우에만 반환됩니다.
업스트림 ModelArk 오류 코드입니다. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected, OutputAudioSensitiveContentDetected는 콘텐츠 정책 거부를 나타냅니다. 하나의 계열에는 점으로 구분된 사유가 붙을 수 있습니다. 예: InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation, OutputImageSensitiveContentDetected.DeepFake. 이 값은 열거형이 아닌 개방형 문자열이며, 그 밖의 코드는 검증 및 공급자 실패를 설명합니다. Router는 전송 계층 실패를 덮어쓰지 않으면서 HTTP 400 오류 응답과 HTTP 200 실패 작업 응답에서 정책 계열을 인식합니다.
예시
입력
출력
배포 전 확인
SDK는Idempotency-Key를 생성하고 자동 재시도에 재사용합니다. 수동으로 재시도할 때는 원본 키를 재사용하세요. Router는 연결을 최대 10분간 유지할 수 있습니다.
요청이 실패하면 Router는 그 이유를 설명하는 X-Comfy-Error-Type 응답 헤더를 보냅니다. 422는 Router가 공급자를 호출하기 전에 입력을 거부했음을 의미하고, 413은 요청 본문이 Router가 허용하는 크기보다 컸음을 의미합니다. 결과 URL이 만료될 수 있으므로 생성된 에셋은 즉시 다운로드하세요.
위의 필드 설명에 명시된 크기 제한은 해당 필드에 대한 공급자 자체의 한도이며, 공급자 사양에서 인용한 것입니다. Router는 전체 요청 본문에 별도의 상한을 적용하며, base64로 인코딩된 미디어도 여기에 포함됩니다. 요청 본문 크기를 참고하세요.
이 페이지는 Comfy Router를 통해 호출하는 하나의 파트너 모델을 설명합니다. 동일한 comfy-sdk / @comfyorg/sdk 패키지에는 Comfy Cloud에서 전체 ComfyUI 워크플로 그래프를 실행하기 위한 두 번째 클라이언트도 포함되어 있습니다: Comfy(api_key=...) / new Comfy({ apiKey }), 그리고 client.workflows, client.assets, client.jobs가 있습니다. Comfy SDKs를 참조하세요.
헤더
인증, 멱등성, 요청 ID, 오류 분류, 재시도 간격, 지출 한도.
Router API 사용
모델 검색, 검증 오류, 재시도, 과금.
제한 사항
Router가 현재 지원하지 않는 기능과 대신 사용할 방법.