Skip to main content
베타: Comfy API v2는 0.1.x 버전이며 API 표면은 여전히 변경될 수 있습니다. v2 내 변경 사항은 추가적으로 제공됩니다. 호환성을 깨뜨리는 변경은 v3로 출시됩니다.
외부 애플리케이션에서 ComfyUI 워크플로를 실행하기 위한 공식 버전 관리 HTTP API입니다: 입력 업로드, 워크플로 제출, 실행 관찰, 결과 검색. 대부분의 사용자는 이 API를 Python과 TypeScript로 래핑한 Comfy SDKs부터 시작해야 합니다. 다른 언어로 작업하는 경우 이러한 엔드포인트를 직접 호출하세요.

설계 원칙

  • 폴링 우선. 모든 기능은 일반 GET 폴링으로 접근할 수 있습니다. SSE 스트림은 실시간 개선 사항일 뿐, 결코 진실의 원천은 아닙니다.
  • 모든 것은 재개 가능합니다. 제출은 멱등적이며, 작업 상태와 출력은 expires_at까지 ID로 검색할 수 있습니다.
  • 콘텐츠 주소 지정 에셋. 에셋은 서버에서 계산된 blake3 해시를 키로 하는 blob에 대한 UUID 식별 레코드입니다. 따라서 동일한 입력이 두 번 업로드되지 않습니다.
  • 링크를 따르고 URL을 직접 만들지 마세요. 응답에는 후속 URL이 포함되어 있습니다.
이러한 설계 원칙에 대한 근거는 디자인 노트를 참조하세요.

기본 URL

엔드포인트 카테고리