메인 콘텐츠로 건너뛰기
Router는 파트너 모델을 하나의 동기식 HTTP 호출로 실행하거나, 제출한 뒤 나중에 수집하는 대기 중 요청을 통해 실행합니다. 애플리케이션이 완료된 결과를 기다리거나 나중에 결과를 수집할 수 있고, 모델 자체의 입력 및 출력 필드를 처리할 수 있는 경우에 사용하십시오.

Router가 지원하는 기능

대기 중 제출

동기 경로는 모델이 실행되는 동안 연결을 유지합니다. 비동기 공급자의 경우 Router가 작업을 제출하고 내부적으로 폴링합니다. 대기 중 전달(제출, request_id 받기, 폴링, 수집)이 대안입니다: 대기 중 전달을 참고하세요. 이는 자격 증명 뒤의 워크스페이스로 범위가 지정되므로, Comfy 워크스페이스에서 생성된 키가 필요합니다. 워크스페이스가 없는 레거시 키, 자체 키 사용(bring-your-own-key) 요청, 또는 실행 대기열이 실행할 수 없는 모델은 제출 경로에서 403과 함께 not_enabled를 응답합니다. 어느 모드도 콜백이나 웹훅을 제공하지 않습니다. 요청을 충분히 오래 열어 둘 수 없다면 실행 대기열에 넣으세요. 공급자 자체의 제출 및 폴링 제어가 필요할 때는 파트너 프록시를 사용하세요. 현재 네 개의 모델이 동기 전용이며, 실행 대기열에 제출하면 403 / not_enabled로 거부됩니다: elevenlabs/eleven_sfx_v2, elevenlabs/eleven_v3, elevenlabs/eleven_v4, elevenlabs/eleven_v4_turbo. 이들은 JSON 결과 문서가 아닌 원시 오디오 바이트를 응답하며, 대기 중 전달은 이를 저장할 곳이 없습니다. 동기 경로에서 실행하세요. 이 경로는 해당 바이트를 정상적으로 반환합니다. 네 개의 모델은 실행 대기열 전용이며, 동기 경로에서는 403 / not_enabled로 거부됩니다: ltx/ltx-video-alpha-gen, ltx/ltx-video-to-video-hdr, ltx/ltx-video-to-video-reframe, ltx/ltx-video-upscale. 이들의 작업은 동기 호출이 유지되는 시간보다 오래 지속될 수 있습니다. 동일한 본문을 POST /v2/models/ltx/{model}/requests에 제출하고 실행 대기열에서 결과를 수집하세요. LTX v1 텍스트 기반 비디오 생성 및 이미지 기반 비디오 생성 연산도 같은 이유로 원시 비디오 바이트를 응답하며, 대기 중 전달도 이를 저장할 수 없습니다. 하지만 이들은 Router 모델 id를 통해서가 아니라 /proxy/ltx/v1/…의 파트너 프록시를 통해서만 접근할 수 있습니다. 모든 ltx/* 카탈로그 모델은 실행 대기열에 넣을 수 있는 v2 제출 및 폴링 연산으로 해석됩니다.

서버 데드라인에 도달하면 호출이 끊깁니다

Router의 기본 데드라인은 10분이며, 배포 단위에서 구성할 수 있습니다. 데드라인은 요청이 도착한 시점부터 계산되므로 요청 업로드도 여기에 포함됩니다. 그때까지 본문이 완전히 도착하지 않으면 공급자 호출이 이루어지기 전에 504 / deadline_exceeded가 반환되며, 완료하기에 남은 시간이 너무 적은 호출도 같은 방식으로 거부됩니다. Router가 먼저 오류와 요청 ID를 반환할 수 있도록 클라이언트 타임아웃을 그보다 길게 설정하세요. 504 / deadline_exceeded는 Router가 대기를 중단했음을 의미하고, 504 / provider_timeout은 공급자가 타임아웃했음을 의미합니다. 타임아웃이나 연결 끊김은 해당 생성에 대한 비용이 청구되지 않았다는 증거가 되지 않으며, 수락된 공급자 작업을 취소하지도 않습니다. 재시도하기 전에 타임아웃과 결과 수집를 읽어보세요.

복구는 공급자에 따라 달라집니다

Router는 공급자가 제출을 수락하는 즉시 submit-and-poll 생성에 대한 공급자 핸들을 보유합니다. 그 이후에 연결이 끊기면, 동일한 Idempotency-Key와 동일한 본문으로 다시 전송할 때 두 번째 생성을 시작하지 않고 원본 생성을 수집하며, 추가로 과금되지 않습니다. 이는 Router가 호출을 종료하는 경우(자체 데드라인 또는 클라이언트의 연결 종료)와, 거의 모든 경우에 해당 호출을 처리하던 Router 서버가 호출 도중 재시작되는 경우에도 성립합니다. 예외는 공급자가 제출을 수락한 시점과 Router가 이를 기록하는 시점 사이의 짧은 순간에 재시작이 일어나는 경우입니다. 이때 키는 최대 15분 동안 유지되며, 그 이후 다시 전송하면 새로운 생성이 시작되고 과금됩니다. 재시작 후에는 Router가 원래 핸들러가 사라졌음을 확인하는 동안 최대 약 1분간 다시 전송 시 Retry-After와 함께 409 / concurrency_limit_exceeded가 반환될 수 있습니다. 같은 키로 계속 다시 전송하면 결과를 수집합니다. 재생 가능한 완료된 응답 역시 키 기록에서 가져올 수 있습니다. 연결이 끊긴 모든 호출이 복구 가능한 것은 아닙니다. 전송하기 전에 요청과 키를 보존한 다음, 재시도 결과 표를 사용하십시오. 새 키는 새 호출을 생성하며 추가 요금이 발생할 수 있습니다.

요청 본문 크기 상한

Router는 본문이 **100 MiB(104,857,600바이트)**보다 큰 요청을 거부합니다. 이 상한은 Router가 무엇이든 파싱하기 전에 측정한, 전송한 원시 바이트에 적용되므로 모든 라우트와 동기 및 대기 중 전달 모두에 적용됩니다. 인라인 미디어는 호출자가 이 상한을 마주치는 지점입니다. Base64 인코딩은 바이너리 데이터를 약 4/3로 부풀리므로, 인코딩된 미디어를 담은 본문은 대략 실제 이미지, 오디오, 비디오 바이트 75 MB에서 상한에 도달합니다. 디스크상의 파일이 아니라 인코딩된 문자열의 크기를 기준으로 하고, 한 번의 호출에 포함된 모든 입력을 계산하세요. 참조 이미지 두 개를 담은 요청은 두 이미지 모두에 여유분을 사용하며, 프롬프트, 파라미터, JSON 구조도 포함됩니다. 거부의 형태. 413, X-Comfy-Error-Type에 invalid_input, 그리고 다른 응답과 마찬가지로 X-Comfy-Request-Id가 설정됩니다. 본문은 RouterErrorResponse이며, 이 응답의 detail은 초과된 상한을 설명합니다. detail을 파싱하기보다 error_type을 기준으로 분기하고, API가 반환하는 수치와 이 페이지의 수치가 다르면 API가 반환하는 값을 권위 있는 것으로 취급하세요. Router는 무엇이든 전달하기 전에 거부를 발생시키므로 생성이 실행되지 않았고 아무것도 청구되지 않았습니다. 이 상한은 Idempotency-Key를 포함하든 하지 않든 모든 요청에 적용됩니다. 이는 멱등성 제한이 아니며, 동일한 키를 다시 보내도 결과는 달라지지 않습니다. 너무 큰 본문은 시도할 때마다 너무 큽니다. 공급자는 자체적으로 더 낮은 제한을 부과할 수 있으며, 이 상한에 이르면 대개 그렇게 합니다. 공급자는 인라인 미디어에 대한 자체 상한을 게시하며, 구속력 있는 제약은 둘 중 더 작은 쪽입니다. 예를 들어 Google의 모델은 최대 20 MB(십진수 20,000,000바이트)의 인라인 페이로드를 허용하며, Google 모델 페이지의 Size limit: 20MB 줄은 전체 요청 본문에 대한 Router의 상한이 아니라 Google 자체 사양에서 인용된 Google의 필드별 상한입니다. Router의 상한은 Router가 앞에 두고 있는 모든 파트너 상한보다 의도적으로 높게 설정되어 있으므로, 단일 인라인 에셋에 대해서는 보통 공급자의 자체 제한에 먼저 부딪힙니다. Router의 상한은 하나의 본문에 여러 에셋이 담길 때 구속력을 가집니다. Router의 상한은 통과하지만 공급자의 자체 제한을 초과하는 본문은 Router가 아니라 공급자가 거부하며, 413이 아닌 공급자 오류로 반환됩니다.

요청은 호출자별로 속도 제한됩니다

요청 속도 제한은 모든 Router 작업에 적용됩니다. 호출(invocation), 카탈로그 및 스키마 읽기, 비용 추정, 그리고 대기 중인 제출, 상태, 결과, 취소 호출이 여기에 포함되며, 생성 이전에 거부된 요청도 포함됩니다. 이 제한은 소스 IP가 아니라 인증된 호출자를 따릅니다. 호출자의 공급자 키를 사용한 호출은 예외이며, 공급자 측 제한은 여전히 적용됩니다. 대기 중인 요청을 폴링하면 다른 호출과 동일한 허용량을 소모하므로, 촘촘한 루프를 돌리기보다 상태 읽기에서 제안하는 간격으로 폴링하세요. rate_limited 거부는 대기 중인 요청에 아무런 변화도 주지 않습니다. 요청은 계속 실행되며, 거부된 취소는 아무것도 취소하지 않았으므로 Retry-After 이후에 다시 보내야 합니다. 카탈로그와 스키마 읽기를 캐시하세요. 이 읽기를 ETag와 If-None-Match로 재검증하세요. 재시도 및 약정 지출 필드에 대해서는 헤더를 참고하세요.

호출이 실행되는 동안에는 진행 상황이 표시되지 않음

Router는 최종 응답만 반환하며, 스트리밍되는 토큰, 서버 전송 이벤트(Server-Sent Events), 백분율 업데이트, 중간 미리보기 프레임은 제공하지 않습니다. 요청이 처리되는 동안 공급자의 내부 폴링 상태는 전달되지 않습니다. 불확정 진행 표시기를 사용하세요. 진행 상황이나 스트리밍이 필요하다면 이를 노출하는 파트너 프록시 작업을 사용하세요.

Comfy 요금 및 사용량

응답에는 공급자 사용량 또는 비용 필드가 포함될 수 있습니다. 이는 보편적인 Comfy 요금을 나타내지 않습니다. X-Comfy-Credits-Used는 선택 사항입니다. 헤더가 누락되었다는 것은 비용이 보고되지 않았음을 뜻할 뿐, 실행이 무료였다는 뜻은 아닙니다. 재생된 응답(Idempotent-Replayed: true)에는 다시 요금이 부과되지 않지만 원본 실행의 수치를 다시 기재할 수 있으므로, 하나의 Idempotency-Key에 대한 재시도 전체에 걸쳐 이 헤더를 합산해서는 안 됩니다. 잔액, 사용량, 청구서는 Comfy 플랫폼을 사용하세요. 카탈로그는 가격 없이 billing.charges_on_policy_rejection을 비롯한 청구 관련 사실 정보를 제공합니다. yes, no, unknown을 명시적으로 처리하세요. 값이 yes일 때 동기식 content_policy_violation 오류는 X-Comfy-Credits-Used를 포함할 수 있습니다. 공급자가 모델의 생성된 출력을 거부했고 Comfy가 그 거부된 생성에 대한 사용량을 기록한 경우에는 이 헤더가 포함되어 해당 수량을 담습니다. 입력 측 거부, 동일 키 재생, 그리고 헤더의 소수점 두 자리로 표시하기에 너무 작은 청구 금액은 이 헤더를 포함하지 않습니다. 헤더가 없는 거부는 보고되지 않은 것이지 무료인 것이 아닙니다. 자세한 내용은 billing을 참조하세요. 실행 전에 가격을 확인하려면 POST /v2/models/{provider}/{model}/estimate를 호출하거나, 대기 중인 제출의 201 응답에서 estimate 객체를 읽으세요. 배포에서 추정 기능이 꺼져 있으면 이 경로는 error_type: not_enabled와 함께 403을 반환하고, 제출 응답에서는 estimate가 생략됩니다. 각 추정치는 Comfy의 표준 정가로 산정되며(공급자가 보고하는 비용으로 청구되는 모델은 대신 공급자의 공개 가격표에서 가격이 산정됩니다. 해당 가격표가 금액을 완전히 결정하는 옵트인한 소수 모델 집합에서는 exact, 그 외의 경우에는 estimated이며, 가격표만으로 금액이 완전히 결정되는 일부 견적도 여기에 포함됩니다), 계약 또는 고객별 요율을 반영하지 않습니다. 협상된 가격이 있는 워크스페이스에는 정가가 견적되고 계약 요율이 청구됩니다. 이 수치는 추정치일 뿐 최종 청구 금액이 아니며, 워크스페이스의 사용량 및 청구 기록에 정산된 금액이 최종입니다. 이는 가격 고정도 아닙니다. 자체 공급자 키로 실행한 경우에는 /estimate가 그 실행의 수치를 반환하더라도 Comfy가 요금을 청구하지 않으며, unknown 추정치에는 수치가 없는데 이는 무료라는 뜻이 아닙니다. X-Comfy-Credits-Used는 실행에 대한 반올림된 사후 수치일 뿐 영수증이 아닙니다. exact, estimated, unknown을 읽는 방법은 실행 전 비용 추정을 참조하세요. 실행 전에 가격을 산정할 수 없는 모델은 사전 추정치가 없는 모델에 나열되어 있습니다.

사전 견적이 없는 모델

Router는 아직 아래 모델에 대한 호출 비용을 실행 전에 안정적으로 산정할 수 없으므로, 이들 모델에 대해서는 /estimate와 대기 중인 제출의 estimate가 source: unknown으로 응답할 것으로 예상해야 합니다. 다만 일부 모델은 특정 요청 본문에 대해서는 값을 반환할 수도 있습니다. unknown은 실행이 무료라는 뜻이 아니라, 값이 제시되지 않았다는 뜻입니다. Comfy 요금 및 사용량 규칙은 여전히 적용됩니다. 자체 공급자 키로 실행한 경우 Comfy에서 과금하지 않으며, X-Comfy-Credits-Used는 선택 사항이므로 헤더가 누락되었다면 비용이 보고되지 않았다는 뜻입니다. 여기에 나열되지 않은 모델도 특정 요청 본문에 대해 unknown으로 응답할 수 있으므로, 모든 견적에서 source를 확인하세요. 이 목록은 견적 적용 범위가 늘어나면 줄어듭니다. 이 목록은 Router 자체의 가격 책정 코드에서 생성되며, 공개적으로 사용할 수 없는 모델은 나열되지 않습니다.
  • bfl: bfl/erase-v1, bfl/video-edit-v1, bfl/video-upscale-v1, bfl/vto-v1
  • fal: fal/fal-seedance-2.0, fal/fal-seedance-2.5
  • freepik: freepik/ai-image-upscaler-precision-v2, freepik/ai-skin-enhancer-creative, freepik/ai-skin-enhancer-faithful, freepik/ai-skin-enhancer-flexible
  • heygen: heygen/starfish
  • ideogram: ideogram/ideogram-v3, ideogram/ideogram-v4
  • kelly: kelly/kelly-seedance-2.0, kelly/kelly-seedance-2.0-fast, kelly/kelly-seedance-2.5
  • kling: kling/kling-4.0, kling/kling-image-o1, kling/videos-avatar-image2video, kling/videos-lip-sync
  • ltx: ltx/ltx-video-alpha-gen, ltx/ltx-video-to-video-hdr, ltx/ltx-video-to-video-reframe, ltx/ltx-video-upscale
  • luma: luma/photon-1, luma/photon-flash-1
  • minimax: minimax/minimax-gpt-image-2, minimax/minimax-gpt-image-2.5-flare, minimax/minimax-gpt-image-2.5-sunburst, minimax/minimax-gpt-image-2.6-flare, minimax/minimax-gpt-image-2.6-sunburst, minimax/minimax-h3-image, minimax/minimax-h3-image-highspeed
  • moonvalley: moonvalley/image-to-video, moonvalley/text-to-video, moonvalley/video-to-video
  • openai: openai/gpt-image-1.5
  • openrouter: openrouter/chat-completions
  • pika: pika/pika-gpt-image-2, pika/pika-nano-banana-2, pika/pika-nano-banana-pro
  • pixverse: pixverse/v3.5, pixverse/v6, pixverse/v6-max
  • quiver: quiver/arrow-2, quiver/arrow-2-telos
  • runware: runware/runware-gpt-image-2, runware/runware-gpt-image-2.5-flare, runware/runware-gpt-image-2.5-sunburst, runware/runware-nano-banana-2, runware/runware-nano-banana-pro, runware/runware-seedance-2.0, runware/runware-seedance-2.5
  • synclabs: synclabs/sync-3
  • veed: veed/video-background-removal, veed/video-background-removal-fast, veed/video-background-removal-green-screen
  • wavespeed: wavespeed/wavespeed-gpt-image-2, wavespeed/wavespeed-gpt-image-2.5-flare, wavespeed/wavespeed-gpt-image-2.5-sunburst
openai/gpt-image-2, openai/gpt-image-2.5-flare, openai/gpt-image-2.5-sunburst, openai/gpt-image-2.6-flare, openai/gpt-image-2.6-sunburst의 편집 작업에도 사전 견적이 없습니다. 이들 모델 중 하나로 보내는 편집 호출이나 입력 이미지를 함께 전달하는 생성 호출은 source: unknown으로 응답합니다. 이들 모델로 보내는 텍스트 전용 생성 호출은 견적이 산정되므로 위 목록에 포함되어 있지 않습니다.

Router는 모든 파트너 작업을 다루지 않습니다

Router는 모델을 실행합니다. 파일 업로드, 계정 읽기, 에셋 관리, 스트리밍, 공급자 작업 제어에는 /proxy/… 아래의 파트너 프록시 경로가 필요할 수 있으며, 이 경로들은 Router 외부에 있고 그 계약에 설명되어 있지 않습니다. Router 자체의 표면은 Comfy Router 사양이며, 지원 범위는 공급자마다 다릅니다.

Krea 3 참조 이미지: 먼저 업로드하거나 공개 https URL 사용

krea/krea-3의 image_urls에서 POST /proxy/krea/assets가 반환한 image_url(https://app-uploads.krea.ai/... URL)은 항상 허용됩니다. 다른 링크가 허용되는지는 환경에 따라 다릅니다. api.comfy.org에서는 현재 허용됩니다. 8개를 초과하는 항목은 요청의 스키마 검사에 의해 가져오기 전에 422로 거부됩니다.
  • 다른 링크가 허용되는 경우, 공개 https 이미지 URL이면 모두 작동합니다. Router는 모델이 실행되기 전에 각 참조 이미지를 직접 가져와 크기를 읽습니다. 수정해야 하는 참조 이미지는 호스트 이름을 명시한 400 invalid_input으로 거부됩니다. 즉, 존재하지 않거나 공개적으로 접근할 수 없는 호스트, 408 또는 429가 아닌 4xx로 응답하는 오리진, 리디렉션이 너무 많은 경우, https가 아닌 링크 또는 공개적으로 접근할 수 없는 호스트로의 리디렉션, 지원되는 이미지가 아닌 콘텐츠, 길이 정보 없이 이미지 크기 헤더 전에 끝나는 응답, 또는 크기 헤더가 처음 2 MiB 이내에 없는 이미지(아래 참조)입니다. 다른 가져오기 실패는 대신 5xx 오류입니다(Router에서는 500 internal_error). 그중 일부는 저절로 해결되므로(DNS 리졸버 오류, 시간 초과, 끊어진 연결, 5xx, 408 또는 429로 응답하는 오리진, 또는 Router의 호스트 검사와 연결 사이에 DNS 응답이 비공개 주소로 바뀌는 호스트. 이 경우 재시도 시 성공할 수도 있고 비공개 호스트에 대한 400으로 거부될 수도 있습니다) 나중에 다시 시도하세요. 다른 실패는 매번 같은 방식으로 실패합니다. 예를 들어 가져오기가 신뢰하지 않는 TLS 인증서(자체 서명됨, 만료됨 또는 잘못된 호스트 이름 대상) 또는 가져오기가 따르지 않는 200이 아닌 2xx나 3xx로 응답하는 오리진(예: 204, 206, 300, 304, 305, 또는 Location이 없는 301, 302, 303, 307, 308)입니다. 재시도해도 같은 방식으로 실패하면 먼저 이미지를 업로드하세요. POST /v2/models/krea/krea-3/requests로 대기 중인 요청은 링크 중 하나라도 app-uploads.krea.ai 링크가 아니면 이러한 5xx에서 재시도되지 않으므로 원인이 해결될 수 있다면 직접 다시 제출하세요. 유효한 업로드가 아닌 app-uploads.krea.ai 링크는 다른 접근 불가능한 참조 이미지와 마찬가지로 400으로 거부됩니다. 대기 중인 요청의 400에는 일반적인 invalid_input 세부 정보만 포함되므로 호스트 이름을 명시하지 않으며, 실행 대기열은 이를 재시도하지 않습니다. 대기 중인 400은 image_urls뿐 아니라 모든 필드(예: 지원되지 않는 resolution 또는 thinking_mode)에서 발생할 수 있으므로 다른 필드를 먼저 확인하세요. 다른 필드가 유효하다면 POST /proxy/krea/assets로 각 이미지를 업로드하고 해당 image_url 값과 새 Idempotency-Key(또는 키 없음)로 다시 제출하세요. 변경된 본문으로 키를 재사용하면 409 invalid_input으로 거부되며, 이는 이미지에 대한 어떤 정보도 제공하지 않습니다. 동일한 본문으로 키를 재사용하면 원본 request_id와 Idempotent-Replayed: true와 함께 201로 응답되므로 새 실행이 시작되지 않으며, 해당 결과 URL(GET /v2/models/krea/krea-3/requests/{request_id})은 동일한 400을 반환합니다(해당 상태 URL은 error_type invalid_input과 함께 200으로 응답합니다). 그 재제출도 400으로 실패하면 이미지 자체가 문제입니다(예: 지원되는 이미지가 아니거나 크기 헤더가 처음 2 MiB 이내에 없음).
  • 다른 링크가 허용되지 않는 경우, 모든 항목은 업로드에서 반환된 image_url이어야 합니다. Router는 링크가 호스트가 정확히 app-uploads.krea.ai인 https URL로 구문 분석되는지만 확인합니다(다른 호스트 없음, 명시적 포트 없음). 그 밖의 링크는 직접 호스팅하는 공개 https URL을 포함해 모델이 실행되기 전에 400 invalid_input과 함께 “image_urls must be image_url values returned by POST /proxy/krea/assets”라는 메시지로 거부되므로 대신 이미지를 업로드하세요. 해당 검사를 통과했지만 유효한 업로드가 아닌 링크(만료됨, 삭제됨 또는 잘못 입력됨)는 여전히 검사를 통과하며, 그러면 Router가 이미지 크기를 읽지 못하고 400이 아닌 5xx 오류로 응답합니다. Router가 읽을 수 없는 업로드된 이미지(예: 지원되는 이미지가 아니거나 크기 헤더가 처음 2 MiB 이내에 없음)도 여기서는 400이 아니라 5xx(Router에서는 500 internal_error)로 실패하며, 여전히 이미지 자체가 문제이므로 다시 업로드해도 도움이 되지 않습니다.
  • 서버가 시작된 직후, 어떤 규칙이 적용되는지 파악하기 전에는 app-uploads.krea.ai 링크가 아닌 모든 https URL이 503(Router에서는 service_unavailable)으로 실패할 수 있으며, 이는 재시도해도 안전합니다(대기 중인 요청은 이 오류에서 자동으로 재시도됩니다).
Router는 크기를 찾기 위해 각 참조 이미지의 처음 2 MiB만 읽습니다. 따라서 해당 창 안에서 크기 정보를 끝까지 읽지 못하는 이미지, 예를 들어 2 MiB가 넘는 임베디드 메타데이터를 담은 JPEG, 또는 팔레트 PNG로서 투명도 데이터가 있거나 없는 경우 첫 이미지 데이터 청크의 시작이 2 MiB를 넘어 위치하는 경우(예: 2 MiB가 넘는 텍스트 또는 색상 프로필 청크 뒤)는 크기 헤더가 처음 2 MiB 이내에 없다는 메시지와 함께 400으로 거부되며, 업로드해도 도움이 되지 않습니다. 먼저 큰 메타데이터 없이 다시 저장하거나, 팔레트 PNG를 비팔레트(트루컬러) PNG로 저장하세요. 국제화 호스트 이름은 ASCII(퓨니코드) 형식으로 보내세요. 예를 들어 bücher.de 대신 xn--bcher-kva.de를 사용하세요. Router는 호스트를 적힌 그대로 조회하며, ASCII가 아닌 이름은 존재하지 않는 호스트로 거부됩니다. 업로드는 모든 환경에서 작동하므로 이식 가능한 선택입니다. 항상 업로드가 반환한 그대로 image_url을 전달하세요. 이미지가 아직 공개 https URL에 없다면 먼저 업로드하세요:
  1. 각 참조 이미지를 multipart/form-data로 업로드하며, 이미지는 폼 필드 file에 담습니다 (JPEG, PNG 또는 WebP, 최대 75 MB). Router와 동일한 방식으로 X-API-Key 또는 Authorization: Bearer를 사용해 인증합니다.
  2. JSON 응답에서 image_url을 읽어 image_urls에 전달합니다:
텍스트 기반 이미지 생성 호출은 image_urls를 생략하며 업로드가 필요하지 않습니다.

모델 출력 및 저장된 에셋

입력과 출력 필드는 모델에 따라 다릅니다. 공급자 SDK나 프록시에서 옮겨오면 라우트와 결과를 읽는 방식이 모두 달라질 수 있습니다. 일부 에셋은 Comfy 스토리지에 다시 호스팅되고, 다른 에셋은 공급자 URL이거나 인라인 바이트입니다. 수명과 재생 동작은 결과 에셋을 참조하세요.

다음

빠른 시작

Comfy Router를 통해 첫 번째 이미지를 생성해 보세요.

Router API 사용하기

모델을 선택하고 스키마를 확인한 뒤 결과와 재시도를 처리합니다.