Skip to main content
Beeble에서 제공하고 Comfy Router가 서비스하는 beeble/switchx의 API 레퍼런스입니다.

빠른 시작

Comfy 워크스페이스에서 키를 생성하고 COMFY_API_KEY로 내보내세요. Python 및 TypeScript 스니펫은 Comfy SDK(pip install comfy-sdk, npm install @comfyorg/sdk)를 사용하며, cURL 스니펫은 동일한 호출을 원시 HTTP로 수행합니다. 모델 ID: beeble/switchx 엔드포인트: POST https://api.comfy.org/v2/models/beeble/switchx

스키마

입력

string
필수
알파 모드: auto, fill, custom, select가능한 값: auto, fill, custom, select
string
사용자 지정 알파 매트의 URI입니다. alpha_mode가 custom 또는 select일 때 필수입니다. auto 또는 fill일 때는 무시됩니다.
string
완료 또는 실패 시 webhook 알림을 받을 HTTPS URL입니다.
string
필수
출력 유형: 이미지 또는 비디오가능한 값: image, video
string
안전한 재시도를 위한 멱등성 키입니다. 동일한 키를 가진 작업이 이미 계정에 존재하면 API는 복제를 생성하지 않고 기존 작업의 상태를 반환합니다.
integer
기본값:"1080"
최대 출력 해상도: 720 또는 1080 (기본값: 1080).
string
원하는 출력에 대한 텍스트 설명입니다(최대 2,000자). prompt 또는 reference_image_uri 중 최소 한 개가 필요합니다.
string
스타일 전송을 위한 참조 이미지의 URI입니다. source_uri와 동일한 URI 유형을 허용합니다.
string
필수
소스 이미지 또는 비디오의 URI입니다. beeble://uploads/{id}/{filename}, https URL 또는 data:{mime};base64 URI(최대 50 MB)를 허용합니다.
GET /v2/models/beeble/switchx/openapi.json에서 Router가 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에게 도달하기 이전에 호출을 검증하는 데 사용하는 것과 동일한 문서입니다.

출력

string
auto, fill, custom, select
string
작업이 완료되거나 실패한 시점의 ISO 8601 타임스탬프입니다.
string
작업이 생성된 시점의 ISO 8601 타임스탬프입니다.
string
오류 메시지입니다(status가 failed일 때 표시됩니다).
string
이미지 또는 비디오
string
필수
작업 식별자(swx_…)
string
마지막 상태 변경 시점의 ISO 8601 타임스탬프입니다.
object
SwitchX 작업 출력에 대한 서명된 URL입니다.
string
알파 매트 URL입니다.
string
합성된 출력 URL입니다.
string
전처리된 소스 URL입니다.
integer
진행률 백분율(0-100)입니다.
string
필수
현재 작업 상태입니다.가능한 값: in_queue, processing, completed, failed
object
SwitchX 작업의 webhook 전송 상태입니다.
integer
지금까지의 전송 시도 횟수입니다.
string
마지막으로 실패한 전송 시도의 오류 메시지입니다.
string
대기 중, 전송됨 또는 실패

예제

입력

출력

배포 전 확인

SDK는 Idempotency-Key를 생성하고 자동 재시도에서 재사용합니다. 수동 재시도 시에는 원래 키를 재사용하세요. Router는 연결을 최대 10분간 유지할 수 있습니다. 요청이 실패하면 Router는 이유를 설명하는 X-Comfy-Error-Type 응답 헤더를 보냅니다. 422는 Router가 프로바이더를 호출하기 전에 입력을 거부했음을 의미합니다. 생성된 에셋은 결과 URL이 만료될 수 있으므로 즉시 다운로드하세요.

헤더

인증, 멱등성, 요청 ID, 오류 분류, 재시도 간격, 지출 한도.

Router API 사용

모델 검색, 유효성 검사 오류, 재시도, 과금.

제한 사항

Router가 현재 지원하지 않는 기능과 대체 방법.