메인 콘텐츠로 건너뛰기
Comfy Router의 정식 라우트로, 모델 ID로 주소가 지정됩니다. 기본 URL: https://api.comfy.org 아래의 모든 엔드포인트에는 인증이 필요합니다. X-API-Key: <api-key> 또는 Authorization: Bearer <jwt>를 전송하십시오. Comfy API 키는 Bearer 토큰으로도 전송할 수 있습니다. 두 자격 증명 헤더를 모두 제공하면 X-API-Key가 우선합니다. 키와 JWT의 구분은 인증 헤더를, 액세스 요구 사항은 퀵스타트를 참고하십시오.

엔드포인트

GET /v2/models

Comfy Router가 실행할 수 있는 모델을 나열합니다. 사용 가능한 모델 ID와 청구 정보를 나열합니다. has_more가 참인 동안 next_cursor를 사용하세요. 파라미터
RouterPageCursor
불투명 페이지네이션 커서입니다.유형: RouterPageCursor. next_cursor로 반환되는 불투명 커서, 1–512자
integer
한 페이지에 반환할 모델 수입니다.최대 100, 기본값: 20
string
호출자가 이전 200 응답에서 보유한 ETag입니다.
응답
RouterModelListResponse
OK: 모델 카탈로그의 한 페이지입니다.본문: RouterModelListResponse. 헤더: X-Comfy-Request-Id, ETag, Cache-Control
no body
Not Modified: 호출자가 If-None-Match로 보낸 ETag 이후 페이지가 변경되지 않았습니다.헤더: X-Comfy-Request-Id, ETag, Cache-Control
RouterErrorResponse
유효하지 않은 요청입니다. 오류 유형과 요청 본문을 확인하세요.본문: RouterErrorResponse. 헤더: X-Comfy-Error-Type, X-Comfy-Request-Id
RouterErrorResponse
자격 증명이 누락되었거나 유효하지 않습니다.본문: RouterErrorResponse. 헤더: X-Comfy-Error-Type, X-Comfy-Request-Id
RouterErrorResponse
이 호출자 또는 모델에 대해서는 요청이 허용되지 않습니다.본문: RouterErrorResponse. 헤더: X-Comfy-Error-Type, X-Comfy-Request-Id
RouterErrorResponse
rate_limited: 호출자의 요청 허용량이 소진되었습니다. 다음 요청을 보내기 전에 Retry-After를 기다리세요.본문: RouterErrorResponse. 헤더: X-Comfy-Error-Type, X-Comfy-Request-Id, Retry-After
RouterErrorResponse
Router를 일시적으로 사용할 수 없습니다. 백오프를 적용해 재시도하세요.본문: RouterErrorResponse. 헤더: X-Comfy-Error-Type, X-Comfy-Request-Id

GET /v2/models/{provider}/{model}

정식 모델 ID로 파트너 모델 하나의 카탈로그 항목을 조회합니다. 전체 카탈로그를 나열하지 않고 한 모델의 세부 정보를 조회합니다. 파라미터
RouterProviderSegment
필수
정식 {provider}/{model} 모델 ID의 공급자 부분입니다.유형: RouterProviderSegment — 영숫자 슬러그, 예: anthropic, 최대 64자
RouterModelSegment
필수
정식 {provider}/{model} 모델 ID의 모델 부분입니다.유형: RouterModelSegment — 영숫자 슬러그, 예: claude-opus-4-6, 최대 128자
string
호출자가 이전 200 응답에서 보유한 ETag입니다.
응답
RouterModelDetail
OK - 모델의 카탈로그 항목입니다.본문: RouterModelDetail — 헤더: X-Comfy-Request-Id, ETag, Cache-Control
no body
Not Modified - 호출자가 If-None-Match로 보낸 ETag 이후 항목이 변경되지 않았습니다.헤더: X-Comfy-Request-Id, ETag, Cache-Control
RouterErrorResponse
자격 증명이 누락되었거나 유효하지 않습니다.본문: RouterErrorResponse — 헤더: X-Comfy-Error-Type, X-Comfy-Request-Id
RouterErrorResponse
이 호출자 또는 모델에 대해서는 해당 요청이 허용되지 않습니다.본문: RouterErrorResponse — 헤더: X-Comfy-Error-Type, X-Comfy-Request-Id
RouterErrorResponse
모델 ID를 찾을 수 없습니다.본문: RouterErrorResponse — 헤더: X-Comfy-Error-Type, X-Comfy-Request-Id
RouterErrorResponse
rate_limited: 호출자의 요청 허용량이 소진되었습니다. 다음 요청을 보내기 전에 Retry-After만큼 기다리세요.본문: RouterErrorResponse — 헤더: X-Comfy-Error-Type, X-Comfy-Request-Id, Retry-After
RouterErrorResponse
Router를 일시적으로 사용할 수 없습니다. 백오프를 두고 재시도하세요.본문: RouterErrorResponse — 헤더: X-Comfy-Error-Type, X-Comfy-Request-Id

POST /v2/models/{provider}/{model}

정규 모델 ID로 파트너 모델을 동기적으로 실행합니다. 모델을 실행하고 완료된 결과를 같은 응답에서 받습니다. 파라미터
RouterProviderSegment
필수
정규 {provider}/{model} 모델 ID의 공급자 부분입니다.유형: RouterProviderSegment — 영숫자 슬러그(예: anthropic), 최대 64자
RouterModelSegment
필수
정규 {provider}/{model} 모델 ID의 모델 부분입니다.유형: RouterModelSegment — 영숫자 슬러그(예: claude-opus-4-6), 최대 128자
string
하나의 논리적 호출을 안전하게 재시도할 수 있게 해 주는 호출자 생성 키입니다.1–255자
string
이 모델을 현재 기본 공급자 대신 다른 공급자가 처리하도록 선택합니다. fal, wavespeed, runware, higgsfield가 대체 공급자이며, GET /v2/models/{provider}/{model}은 주어진 모델이 이 중 어떤 공급자를 지원하는지 보고합니다. 거부 사유는 정해진 순서로 검사되며, 앞선 사유는 나중 사유의 해당 여부와 무관하게 응답으로 이어집니다. 인식할 수 없는 값, 즉 등록된 공급자가 전혀 아닌 값은 400으로 거부됩니다. 그다음, 본문이 멀티파트 작업(편집)을 선택하는 요청에 대체 공급자를 지정하면 detail이 “this request’s image selects the edit operation”로 시작하는 409로 거부되지만, 이는 해당 공급자의 이 모델용 변환기가 그 작업을 처리할 수 없을 때만이며, 변환기가 미디어를 처리할 수 있는 경로는 정상적으로 진행됩니다. 그다음, 자체 키(BYOK) 자격 증명이 확인된 요청에서는 해당 공급자가 이 모델을 처리하는지와 무관하게 모든 대체 공급자가 detail이 this request resolved a BYOK credential로 시작하는 409로 거부됩니다(해당 응답 참조). 그다음, 지정된 공급자 자체의 게이트가 적용되며, 해당 공급자가 사용자에게 활성화되어 있지 않으면 error_type: not_enabled와 함께 403으로, 게이트를 평가할 수 없으면 error_type: service_unavailable과 함께 503으로 거부합니다. 이 네 가지를 모두 통과한 뒤에야, 이 모델에 대한 경로가 없는 실제 공급자가 error_type: invalid_input와 함께 400으로 거부되며, 이는 인식할 수 없는 값과 같은 응답입니다. fallback_provider는 자체 키 요청, 본문이 멀티파트 작업을 선택하는 요청, 그리고 strict_mode=true에서 거부되지 않고 아무 효과도 없습니다.
boolean
model_provider와 함께 사용할 때만 의미가 있습니다.기본값: False
string
첫 시도가 Router 또는 시도한 공급자에 기인한 이유로 실패했을 때, Router가 이 호출을 모델의 다른 등록 공급자에 대해 재시도할지 여부를 제어합니다. 생략하거나 false가 아닌 값을 지정하면 폴백이 켜진 상태로 유지되고, false는 이를 끕니다. 폴백이 성공하면 응답에 X-Comfy-Router-Fallback-Provider가 포함됩니다. 자체 키(BYOK) 자격 증명이 확인된 요청에서는 이 파라미터의 값과 무관하게 폴백을 사용할 수 없습니다. 재시도는 그저 수행되지 않고 첫 실패가 그대로 전달되며, 이는 거부가 아니라 아무 효과도 없는 동작입니다. 여기서 409가 발생하지는 않습니다. 같은 이유로 본문이 멀티파트 작업을 선택하는 요청과 strict_mode=true에서도 마찬가지입니다. 각각은 호출을 다른 공급자에 대해 충실히 재현할 수 없는 하나의 공급자에 묶으므로, 폴백은 거부되지 않고 그저 건너뜁니다. 오직 명시적인 model_provider만 그 409로 거부되며, 이 무조건적인 건너뜀과 달리 그 멀티파트 409는 변환기가 해당 작업을 처리할 수 없는 경로에만 적용됩니다.
boolean
이 모델의 입력 스키마가 선언하지 않은 최상위 요청 본문 필드를 수용하는 대신 거부하도록 선택합니다. 중첩 필드는 검사하지 않으며, 스키마가 선언되지 않은 필드를 허용하거나 작성된 스키마가 없는 모델에서는 아무것도 거부되지 않고, strict_mode=true로 보낸 대기 중 제출에서도 거부되지 않습니다.기본값: False
요청 본문 application/json — RouterModelInput (필수) 파트너 모델의 네이티브 JSON 입력입니다. model_provider가 없으면 요청은 모델의 기본 공급자에서 네이티브 디스패치를 실행하며, 이 본문은 모델 자체의 네이티브 스키마이고 그대로 전달됩니다(이 경우 strict_mode는 의미가 없고 아무것도 바꾸지 않습니다). model_provider가 대체 공급자를 선택하고 strict_mode=false(기본값)인 경우, 본문은 전송되기 전에 해당 공급자의 실제 스키마로 변환됩니다. 정확히 표현할 수 없는 네이티브 필드는 버려지고 응답의 X-Comfy-Router-Dropped-Params 헤더를 통해 알려지며, 결코 조용히 넘어가지 않습니다. model_provider가 대체 공급자를 선택하고 strict_mode=true이면 변환이 실행되지 않습니다. 본문은 이 모델의 네이티브 스키마가 아니라 이미 그 대체 공급자 자체의 실제 스키마여야 하며(strict_mode 참조), 그대로 전달됩니다. 본문의 필드 자체가 둘 이상의 작업을 지원하는 모델에서 Router가 실행할 작업을 선택하기도 합니다. 편집 가능한 이미지 모델의 경우 입력 이미지가 포함되면 텍스트 기반 이미지 생성에서 이미지 기반 이미지 생성(편집) 작업으로 전환되며, 이 작업은 별도의 요율로 과금될 수 있습니다. Seedance 비디오 모델의 경우 content[].role이 작업을 선택합니다(첫 프레임 이미지는 이미지 기반 비디오 생성을, 레퍼런스 이미지 또는 클립은 레퍼런스 기반 비디오 생성을 선택합니다). 네이티브 디스패치에서 Seedance 과금은 역할이 아니라 content의 미디어 종류를 따릅니다. 비디오 입력이 하나라도 있는 요청은 비디오 기반 비디오 생성으로, 그렇지 않고 이미지가 하나라도 있으면 이미지 기반 비디오 생성으로, 그 외에는 텍스트 기반 비디오 생성으로 과금됩니다. 다만 draft_task 항목에서 나온 최종 렌더는 그것이 렌더링하는 Draft의 작업으로 과금됩니다. 일부 모델은 텍스트 기반 비디오 생성과 이미지 기반 비디오 생성을 같은 요율로 과금합니다. model_provider가 대체 공급자를 선택하는 경우, 조건이 적용된 각 작업은 해당 공급자 자체의 요율로 과금될 수 있습니다. 응답
RouterModelOutput
OK - model_provider가 없거나, model_provider와 strict_mode=false(기본값)를 함께 사용하는 경우, 가능하면 이 모델의 네이티브 계약으로 다시 변환하며 변환에 실패하면 대체 공급자 자체의 원시 응답으로 폴백합니다(로그에 기록되며, 결코 조용히 넘어가지 않습니다). 이때 형태는 이 모델 자체의 네이티브 출력입니다. strict_mode=true이면 대체 공급자의 응답이 변경 없이 그대로 반환됩니다. 파트너가 생성 요청에 바이트로 직접 응답하는 모델의 경우, 본문은 application/json이 아니라 파트너 자체의 Content-Type으로 반환되는 해당 바이트입니다. 응답의 Content-Type을 기준으로 분기하고 JSON 문서라고 가정하지 마세요.본문: RouterModelOutput 또는 원시 바이트 (*/*) — 헤더: X-Comfy-Request-Id, X-Content-Type-Options, X-Comfy-Router-Fallback-Provider, X-Comfy-Router-Provider, X-Comfy-Router-Dropped-Params, X-Comfy-Credits-Used, Idempotent-Replayed, X-Committed-Spend-Limit, X-Committed-Spend-Current, X-Committed-Spend-Remaining
RouterErrorResponse
잘못된 요청입니다. 오류 유형과 요청 본문을 확인하세요.본문: RouterErrorResponse — 헤더: X-Comfy-Error-Type, X-Comfy-Request-Id, X-Comfy-Upstream-Status, X-Comfy-Upstream-Detail, X-Comfy-Refusal-Subject, X-Comfy-Credits-Used, Idempotent-Replayed
RouterErrorResponse
자격 증명이 누락되었거나 유효하지 않습니다.본문: RouterErrorResponse — 헤더: X-Comfy-Error-Type, X-Comfy-Request-Id
RouterErrorResponse
Router 요청 수준의 실패입니다. 요청이 모델에 도달하지 않았거나 모델 자체가 보고하지 않은 이유로 실패했습니다.본문: RouterErrorResponse — 헤더: X-Comfy-Error-Type, X-Comfy-Request-Id
RouterErrorResponse
이 호출자 또는 모델에 대해서는 요청이 허용되지 않습니다.본문: RouterErrorResponse — 헤더: X-Comfy-Error-Type, X-Comfy-Request-Id
RouterErrorResponse
모델 ID를 찾을 수 없습니다.본문: RouterErrorResponse — 헤더: X-Comfy-Error-Type, X-Comfy-Request-Id
RouterErrorResponse
X-Comfy-Error-Type을 확인하세요. concurrency_limit_exceeded는 원본 호출이 아직 실행 중이라는 뜻이므로 Retry-After를 기다린 뒤 동일한 키를 재사용하세요. invalid_input은 새 키가 필요합니다. 이 경로에서 발생하는 두 가지 invalid_input 충돌은 키와 전혀 무관하며 새 키로도 어느 쪽도 해결되지 않습니다. 대체 공급자를 지정하는 model_provider는 요청 본문이 해당 공급자의 이 모델용 번역기가 처리할 수 없는 멀티파트 작업(편집)을 선택할 때 거부됩니다. 이때 detail은 “this request’s image selects the edit operation”로 시작합니다. 그리고 그 이후에 확인되는 충돌로, 요청이 경로에 있는 공급자에 대해 BYOK(bring-your-own-key) 자격 증명을 이미 확인한 경우에는 detail이 this request resolved a BYOK credential로 시작합니다. model_provider를 제거하거나, BYOK 자격 증명 없이, 멀티파트의 경우에는 편집 없이 요청을 보내세요.본문: RouterErrorResponse — 헤더: X-Comfy-Error-Type, X-Comfy-Request-Id, Retry-After (concurrency_limit_exceeded인 경우)
RouterErrorResponse
요청 본문이 너무 큽니다.본문: RouterErrorResponse — 헤더: X-Comfy-Error-Type, X-Comfy-Request-Id
RouterValidationErrorResponse
요청 콘텐츠가 모델의 스키마에 맞지 않아 거부되었습니다.본문: RouterValidationErrorResponse — 헤더: X-Comfy-Error-Type, X-Comfy-Request-Id, Idempotent-Replayed
RouterErrorResponse
X-Comfy-Error-Type을 확인하세요. concurrency_limit_exceeded는 진행 중인 호출을 줄이라는 뜻이고, rate_limited는 Retry-After에 지정된 시간만큼 기다리라는 뜻입니다.본문: RouterErrorResponse — 헤더: X-Comfy-Error-Type, X-Comfy-Request-Id, X-Committed-Spend-Limit, X-Committed-Spend-Current, X-Committed-Spend-Remaining, X-Model-Concurrency-Limit, X-Model-Concurrency-Current, X-Model-Concurrency-Remaining, Retry-After (rate_limited인 경우)
RouterErrorResponse
공급자 자체의 응답을 결과로 변환할 수 없습니다 (provider_error).본문: RouterErrorResponse — 헤더: X-Comfy-Error-Type, X-Comfy-Request-Id, X-Comfy-Upstream-Status
RouterErrorResponse
Router를 일시적으로 사용할 수 없습니다. 백오프를 두고 재시도하세요.본문: RouterErrorResponse — 헤더: X-Comfy-Error-Type, X-Comfy-Request-Id, Retry-After (용량 거부 시에만)
RouterErrorResponse
요청이 기한을 초과했습니다. 재시도하기 전에 오류 유형을 확인하세요.본문: RouterErrorResponse — 헤더: X-Comfy-Error-Type, X-Comfy-Request-Id, X-Comfy-Upstream-Status, Retry-After

POST /v2/models/{provider}/{model}/estimate

모델 호출을 실행하기 전에, 실행하지 않고 가격을 산정합니다. 이 모델에서 이 본문을 실행하는 데 드는 비용을 미국 달러로 사전에 견적해 반환하며, Comfy의 표준 정가로 가격이 책정됩니다(공급자가 보고한 비용으로 청구되는 모델은 대신 공급자의 게시된 가격표를 기준으로 견적됩니다). 계약 또는 고객별 요율은 반영하지 않습니다: 협상된 가격이 있는 워크스페이스에는 정가가 견적되고 계약 요율로 청구되므로, 이때 source: exact는 해당 워크스페이스의 청구 금액이 아니라 정가 기준으로 정확하다는 뜻입니다. 이는 최종 청구가 아닌 견적입니다: 실제로 지불하는 금액은 워크스페이스의 사용량 및 청구 기록에 정산된 청구 금액입니다. 본문은 먼저 모델의 입력 스키마에 대해 검증됩니다. 기본 실행(strict_mode 없음, reject_unknown_fields 없음)이 검증하는 방식과 같으므로, 모델 스키마를 통과하지 못하는 본문은 실행 시와 마찬가지로 여기서도 동일한 422입니다. 공급자에게 아무것도 디스패치되지 않으며 아무것도 청구되지 않습니다. 이 응답은 가격을 고정하지 않습니다: pricing_as_of 시점에 시행 중인 요율로 가격이 책정되며, 실행은 요금이 산정되는 시점에 시행 중인 요율로 청구됩니다. 배포에서 견적 기능이 꺼져 있으면 이 경로는 error_type: not_enabled와 함께 403을 응답합니다. Router가 아직 실행할 수 없는 모델의 경우 실행 경로 자체의 detail과 함께 동일한 403을 응답하므로, 두 경우를 구분하려면 detail을 읽으십시오. 본문은 Router가 디스패치할 방식으로 가격이 책정됩니다: 본문이 지정한 model_provider 구간에 맞게 변환되고 실행되는 작업으로 대상이 재지정되며, 대기 중인 제출의 201에 있는 estimate와 동일한 순서를 따릅니다. 그러나 그 estimate는 사전 가격이 아닙니다: 실행이 승인되어 대기열에 들어간 이후에만 도착하며, 해당 실행은 디스패치 전에 취소되지 않는 한 청구됩니다. 파라미터
RouterProviderSegment
필수
정규 {provider}/{model} 모델 ID의 소문자 공급자 세그먼트로, 실행 대상 모델을 보유한 파트너입니다.유형: RouterProviderSegment — 영숫자 슬러그, 예: anthropic, 최대 64자
RouterModelSegment
필수
정규 {provider}/{model} 모델 ID의 소문자 모델 세그먼트로, 해당 공급자 내에서 실행할 모델입니다.유형: RouterModelSegment — 영숫자 슬러그, 예: claude-opus-4-6, 최대 128자
string
이 모델의 현재 기본값 대신 이 모델을 제공할 대체 공급자를 선택합니다.
요청 본문 application/json — RouterModelInput (필수) 파트너 모델의 네이티브 JSON 입력으로, 이 모델에 대해 동기 라우트가 받는 본문과 동일합니다. 기본 실행이 검증하는 방식대로 모델 자체의 입력 스키마에 대해 검증되며(이 라우트는 strict_mode나 reject_unknown_fields를 받지 않습니다), 가격 산정 대상은 본문 자체의 필드(출력 수, 입력 이미지가 선택하는 작업)에 따라 결정됩니다. 응답
RouterCostEstimate
견적입니다.본문: RouterCostEstimate — 헤더: X-Comfy-Request-Id
RouterErrorResponse
유효하지 않은 요청입니다. 오류 유형과 요청 본문을 확인하세요.본문: RouterErrorResponse — 헤더: X-Comfy-Error-Type, X-Comfy-Request-Id
RouterErrorResponse
자격 증명이 누락되었거나 유효하지 않습니다.본문: RouterErrorResponse — 헤더: X-Comfy-Error-Type, X-Comfy-Request-Id
RouterErrorResponse
이 호출자 또는 모델에 대해 허용되지 않는 요청입니다.본문: RouterErrorResponse — 헤더: X-Comfy-Error-Type, X-Comfy-Request-Id
RouterErrorResponse
모델 ID를 찾을 수 없습니다.본문: RouterErrorResponse — 헤더: X-Comfy-Error-Type, X-Comfy-Request-Id
RouterErrorResponse
요청 본문이 너무 큽니다.본문: RouterErrorResponse — 헤더: X-Comfy-Error-Type, X-Comfy-Request-Id
RouterValidationErrorResponse
견적 요청의 본문이 모델 스키마에 대해 거부되었거나, 경로와 다른 모델을 지정했습니다.본문: RouterValidationErrorResponse — 헤더: X-Comfy-Error-Type, X-Comfy-Request-Id
RouterErrorResponse
rate_limited: 호출자의 요청 허용량이 소진되었습니다. 다음 요청을 보내기 전에 Retry-After를 기다리세요.본문: RouterErrorResponse — 헤더: X-Comfy-Error-Type, X-Comfy-Request-Id, Retry-After
RouterErrorResponse
Router를 일시적으로 사용할 수 없습니다. 백오프를 두고 재시도하세요.본문: RouterErrorResponse — 헤더: X-Comfy-Error-Type, X-Comfy-Request-Id, Retry-After (용량 거부 시에만)
RouterErrorResponse
요청이 기한을 초과했습니다. 재시도하기 전에 오류 유형을 확인하세요.본문: RouterErrorResponse — 헤더: X-Comfy-Error-Type, X-Comfy-Request-Id

GET /v2/models/{provider}/{model}/openapi.json

파트너 모델 하나의 입력 및 출력 스키마를 OpenAPI 문서로 조회합니다. 모델 하나의 입력 및 출력 스키마를 독립형 OpenAPI 문서로 조회합니다. 파라미터
RouterProviderSegment
필수
정식 {provider}/{model} 모델 ID에서 공급자에 해당하는 부분입니다.유형: RouterProviderSegment. 영숫자 슬러그(예: anthropic), 최대 64자
RouterModelSegment
필수
정식 {provider}/{model} 모델 ID에서 모델에 해당하는 부분입니다.유형: RouterModelSegment. 영숫자 슬러그(예: claude-opus-4-6), 최대 128자
string
호출자가 이전 200 응답에서 보유한 ETag입니다.
응답
RouterModelInputSchemaDocument
OK: 모델의 입력 및 출력 스키마를 독립형 OpenAPI 문서로 제공합니다.본문: RouterModelInputSchemaDocument. 헤더: X-Comfy-Request-Id, ETag, Cache-Control
no body
Not Modified: 호출자가 If-None-Match에 보낸 ETag 이후 문서가 변경되지 않았습니다.헤더: X-Comfy-Request-Id, ETag, Cache-Control
RouterErrorResponse
자격 증명이 누락되었거나 유효하지 않습니다.본문: RouterErrorResponse. 헤더: X-Comfy-Error-Type, X-Comfy-Request-Id
RouterErrorResponse
이 호출자 또는 모델에는 요청이 허용되지 않습니다.본문: RouterErrorResponse. 헤더: X-Comfy-Error-Type, X-Comfy-Request-Id
RouterErrorResponse
모델 ID를 찾을 수 없습니다.본문: RouterErrorResponse. 헤더: X-Comfy-Error-Type, X-Comfy-Request-Id
RouterErrorResponse
Router가 요청을 완료할 수 없습니다.본문: RouterErrorResponse. 헤더: X-Comfy-Error-Type, X-Comfy-Request-Id
RouterErrorResponse
rate_limited: 호출자의 요청 허용량이 소진되었습니다. 다음 요청을 보내기 전에 Retry-After에 지정된 시간만큼 기다리세요.본문: RouterErrorResponse. 헤더: X-Comfy-Error-Type, X-Comfy-Request-Id, Retry-After
RouterErrorResponse
Router를 일시적으로 사용할 수 없습니다. 백오프를 사용하여 재시도하세요.본문: RouterErrorResponse. 헤더: X-Comfy-Error-Type, X-Comfy-Request-Id

POST /v2/models/{provider}/{model}/requests

파트너 모델 실행 요청을 실행 대기열에 제출하고 즉시 반환합니다. Comfy Router의 대기열 전달 모드입니다. 요청 본문은 POST /v2/models/{provider}/{model}이 이 모델에 대해 받아들이는 파트너 네이티브 JSON 입력과 동일합니다. 하나의 본문 형태, 모델별 하나의 스키마, 두 가지 전달 모드가 있습니다. 다만 이 경로는 결과를 위해 연결을 유지하지 않습니다. 실행을 접수하고 핸들과 함께 201로 응답하며, 호출자는 아래 세 가지 조회를 통해 나중에 결과를 수집합니다. 파라미터
RouterProviderSegment
필수
정규 {provider}/{model} 모델 ID의 소문자 공급자 세그먼트입니다. 모델이 실행되는 파트너입니다.유형: RouterProviderSegment — 영숫자 슬러그(예: anthropic), 최대 64자
RouterModelSegment
필수
정규 {provider}/{model} 모델 ID의 소문자 모델 세그먼트입니다. 해당 공급자 내에서 실행할 모델입니다.유형: RouterModelSegment — 영숫자 슬러그(예: claude-opus-4-6), 최대 128자
string
현재 기본값 대신 이 모델을 서비스할 대체 공급자를 선택합니다.
boolean
model_provider와 함께 사용할 때만 의미가 있습니다.기본값: False
string
호출자가 생성하는 키로, 하나의 논리적 호출을 재시도해도 안전하게 만듭니다.1–255자
boolean
이 모델의 입력 스키마가 선언하지 않은 최상위 요청 본문 필드를 허용하는 대신 거부하도록 선택합니다. 중첩 필드는 검사하지 않으며, 스키마가 선언되지 않은 필드를 허용하거나 작성된 스키마가 없는 모델의 경우, 또는 strict_mode=true로 전송된 대기열 제출에서는 아무것도 거부하지 않습니다.기본값: False
요청 본문 application/json — RouterModelInput (필수) 파트너 모델의 네이티브 JSON 입력으로, 동기 경로가 이 모델에 대해 받아들이는 본문과 동일하며, 수행할 작업을 선택하고 같은 방식으로 과금됩니다. 본문 자체의 필드가 하나 이상의 작업을 지원하는 모델에서 Router가 실행할 작업을 선택합니다(입력 이미지는 편집 가능한 이미지 모델을 이미지 기반 이미지 생성으로 전환하며, 이는 자체 요율로 과금될 수 있습니다. Seedance의 첫 프레임 이미지는 이미지 기반 비디오 생성을 선택하고, 레퍼런스 이미지나 클립은 레퍼런스 기반 비디오 생성을 선택합니다). 네이티브 디스패치에서 Seedance 요청은 역할이 아니라 content의 미디어 종류에 따라 과금됩니다. 비디오 입력이 있으면 비디오 기반 비디오 생성으로, 그렇지 않고 이미지가 있으면 이미지 기반 비디오 생성으로, 그것도 아니면 텍스트 기반 비디오 생성으로 과금됩니다. 단, draft_task 항목의 최종 렌더는 그것이 렌더링하는 Draft의 작업으로 과금되며, 일부 모델은 텍스트 기반 비디오 생성과 이미지 기반 비디오 생성에 동일한 요율을 청구합니다. model_provider로 대체 공급자를 선택하면, 조건이 적용된 각 작업은 해당 공급자 자체의 요율로 과금될 수 있습니다. 동일한 공급자 선택 규약이 디스패치 시에도 적용됩니다. model_provider가 없거나, model_provider와 함께 strict_mode=false(기본값)인 경우, 본문은 모델의 네이티브 문서이며 실행이 접수되기 전에 모델 자체의 입력 스키마에 대해 검증됩니다. 따라서 모델이 거부할 본문은 몇 분 뒤 실패하는 대기 중 요청이 아니라 여기서 422가 됩니다. 비엄격 대체 공급자 본문은 디스패치 시 해당 공급자의 실제 스키마로 추가 변환됩니다. strict_mode=true인 경우 본문은 이미 대체 공급자 자체의 스키마여야 하며 변경 없이 전달됩니다. 동기 경로에서와 정확히 마찬가지로 네이티브 스키마 검증이 건너뜁니다(model_provider 및 strict_mode 참고). 응답
RouterQueueSubmitResponse
생성됨 - 실행이 실행 대기열에 접수되었습니다.본문: RouterQueueSubmitResponse — 헤더: X-Comfy-Request-Id, Idempotent-Replayed, X-Comfy-Router-Dropped-Params
RouterErrorResponse
자격 증명이 누락되었거나 유효하지 않습니다.본문: RouterErrorResponse — 헤더: X-Comfy-Error-Type, X-Comfy-Request-Id
RouterErrorResponse
잘못된 요청입니다. 오류 유형과 요청 본문을 확인하세요.본문: RouterErrorResponse — 헤더: X-Comfy-Error-Type, X-Comfy-Request-Id
RouterErrorResponse
요청 본문이 너무 큽니다.본문: RouterErrorResponse — 헤더: X-Comfy-Error-Type, X-Comfy-Request-Id
RouterErrorResponse
Router 요청 수준의 실패입니다. 요청이 모델에 도달하지 않았거나, 모델 자체가 보고하지 않은 이유로 실패했습니다.본문: RouterErrorResponse — 헤더: X-Comfy-Error-Type, X-Comfy-Request-Id
RouterErrorResponse
이 호출자 또는 모델에 대해 허용되지 않는 요청입니다. 파트너가 생성 결과를 바이트로 직접 응답하는 모델은 아직 대기열에 넣을 수 없으며 not_enabled로 거부됩니다. 대신 동기 경로에서 실행하세요.본문: RouterErrorResponse — 헤더: X-Comfy-Error-Type, X-Comfy-Request-Id
RouterErrorResponse
모델 ID를 찾을 수 없습니다.본문: RouterErrorResponse — 헤더: X-Comfy-Error-Type, X-Comfy-Request-Id
RouterErrorResponse
X-Comfy-Error-Type을 확인하세요: concurrency_limit_exceeded는 원본 호출이 아직 실행 중이라는 뜻이므로 Retry-After에 지정된 시간만큼 기다린 뒤 동일한 키를 재사용하세요. invalid_input은 새 키가 필요하다는 뜻입니다. 이 라우트의 두 가지 invalid_input 충돌은 키와 전혀 관련이 없으며, 새 키로도 어느 쪽도 해결되지 않습니다: model_provider가 대체 공급자를 지정하는 경우, 요청 본문이 해당 공급자의 이 모델용 변환기가 처리할 수 없는 multipart 작업(편집)을 선택하면 거부되며, 이때 detail은 “this request’s image selects the edit operation”로 시작합니다. 그 이후에 확인되는 경우로, 요청이 경로에 있는 공급자에 대해 이미 BYOK 자격 증명을 확인한 경우에도 거부되며, 이때 detail은 this request resolved a BYOK credential로 시작합니다. model_provider를 제거하거나, BYOK 자격 증명 없이, 그리고 (multipart인 경우) 편집 없이 요청을 보내세요.본문: RouterErrorResponse; 헤더: X-Comfy-Error-Type, X-Comfy-Request-Id, Retry-After (concurrency_limit_exceeded일 때)
RouterValidationErrorResponse
요청 내용이 모델의 스키마에 따라 거부되었습니다.본문: RouterValidationErrorResponse; 헤더: X-Comfy-Error-Type, X-Comfy-Request-Id, Idempotent-Replayed
RouterErrorResponse
X-Comfy-Error-Type을 확인하세요: queue_backlog_full은 허용된 개수만큼 아직 끝나지 않은 대기 중 요청을 이미 보유하고 있다는 뜻이므로, 그중 하나가 완료되면 다시 제출하세요. rate_limited는 Retry-After에 있는 초 수만큼 기다리라는 뜻입니다.본문: RouterErrorResponse; 헤더: X-Comfy-Error-Type, X-Comfy-Request-Id, Retry-After (rate_limited일 때)
RouterErrorResponse
Router가 일시적으로 사용할 수 없는 상태입니다. 백오프를 두고 재시도하세요.본문: RouterErrorResponse; 헤더: X-Comfy-Error-Type, X-Comfy-Request-Id, Retry-After (용량 거부 시에만)
RouterErrorResponse
요청이 기한을 초과했습니다. 재시도하기 전에 오류 유형을 확인하세요.본문: RouterErrorResponse; 헤더: X-Comfy-Error-Type, X-Comfy-Request-Id

GET /v2/models/{provider}/{model}/requests/{request_id}

제출된 요청 하나의 결과를 수집합니다. 수집 엔드포인트입니다. 성공적으로 완료된 요청에 대해서는 파트너 모델 자체의 네이티브 출력을 반환하며, 이는 동일한 모델과 동일한 입력에 대해 동기 라우트의 200이 담는 것과 바이트 단위까지 같습니다. 따라서 두 가지 전달 방식이 하나의 결과 형태를 만들고, 호출자는 별도의 파서 없이 두 방식 사이를 오갈 수 있습니다. 파라미터
RouterProviderSegment
필수
정규 {provider}/{model} 모델 ID의 소문자 공급자 세그먼트로, 모델이 실행되는 파트너입니다.유형: RouterProviderSegment — 영숫자 슬러그, 예: anthropic, 최대 64자
RouterModelSegment
필수
정규 {provider}/{model} 모델 ID의 소문자 모델 세그먼트로, 해당 공급자 내에서 실행할 모델입니다.유형: RouterModelSegment — 영숫자 슬러그, 예: claude-opus-4-6, 최대 128자
RouterQueueRequestId
필수
대상으로 지정할 대기 중 요청으로, 제출 시 본문에서 반환된 request_id입니다.유형: RouterQueueRequestId — pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$, uuid, 최대 36자
응답
RouterModelOutput
OK - 결과를 생성한 요청, 즉 성공적으로 완료된 요청이거나 기록된 과금과 저장된 결과를 모두 가진 터미널 요청에 대해 저장된 결과를, 파트너 자체의 미디어 타입으로 변경 없이 반환합니다. 동기 라우트의 200이 반환하는 것과 정확히 같으며, 제출이 수락한 것과 동일한 공급자 선택 계약을 따릅니다: model_provider 없이, 또는 model_provider와 함께 strict_mode=false(기본값, 가능한 경우 이 모델의 네이티브 계약으로 다시 변환되고, 변환에 실패하면 대체 공급자의 원시 응답으로 폴백하며 이는 로그에 남고 결코 조용히 넘어가지 않습니다)인 경우 형태는 이 모델 자체의 네이티브 출력입니다. strict_mode=true이면 대체 공급자의 응답이 변경 없이 반환됩니다. 파트너가 생성 결과를 바이트로 직접 응답하는 모델의 경우, 본문은 application/json이 아니라 파트너 자체의 Content-Type을 따르는 해당 바이트입니다. 응답의 Content-Type을 기준으로 분기하고 JSON 문서라고 가정하지 마세요.본문: RouterModelOutput 또는 원시 바이트 (*/*) — 헤더: X-Comfy-Request-Id, X-Content-Type-Options, X-Comfy-Credits-Used
RouterQueueStatusResponse
Accepted - 요청이 아직 완료되지 않았습니다.본문: RouterQueueStatusResponse — 헤더: X-Comfy-Request-Id, Retry-After
RouterErrorResponse
자격 증명이 누락되었거나 유효하지 않습니다.본문: RouterErrorResponse — 헤더: X-Comfy-Error-Type, X-Comfy-Request-Id
RouterErrorResponse
이 호출자 또는 모델에 대해 요청이 허용되지 않습니다.본문: RouterErrorResponse — 헤더: X-Comfy-Error-Type, X-Comfy-Request-Id
RouterErrorResponse
모델 ID를 찾을 수 없습니다.본문: RouterErrorResponse — 헤더: X-Comfy-Error-Type, X-Comfy-Request-Id
RouterErrorResponse
Router 요청 수준의 실패로, 요청이 모델에 도달하지 않았거나 모델 자체가 보고하지 않은 이유로 실패했습니다.본문: RouterErrorResponse — 헤더: X-Comfy-Error-Type, X-Comfy-Request-Id
RouterErrorResponse
rate_limited: 호출자의 요청 허용량이 소진되었습니다. 다음 요청을 보내기 전에 Retry-After만큼 기다리세요.본문: RouterErrorResponse — 헤더: X-Comfy-Error-Type, X-Comfy-Request-Id, Retry-After
RouterErrorResponse
Router를 일시적으로 사용할 수 없습니다. 백오프를 두고 재시도하세요.본문: RouterErrorResponse — 헤더: X-Comfy-Error-Type, X-Comfy-Request-Id
RouterErrorResponse
요청이 작업과 충돌하는 상태에 있습니다. 오류 유형을 확인하세요.본문: RouterErrorResponse — 헤더: X-Comfy-Error-Type, X-Comfy-Request-Id
RouterErrorResponse
요청이 기한을 초과했습니다. 재시도하기 전에 오류 유형을 확인하세요.본문: RouterErrorResponse — 헤더: X-Comfy-Error-Type, X-Comfy-Request-Id
RouterErrorResponse
Router 요청 수준의 실패로, 요청이 모델에 도달하지 않았거나 모델 자체가 보고하지 않은 이유로 실패했습니다.본문: RouterErrorResponse — 헤더: X-Comfy-Error-Type, X-Comfy-Request-Id

PUT /v2/models/{provider}/{model}/requests/{request_id}/cancel

제출된 요청 하나의 취소를 요청합니다. 아직 완료되지 않은 요청을 중지하도록 Comfy에 요청합니다. 이는 요청일 뿐 보장이 아니며, 202는 바로 그 점을 나타냅니다. CANCELLATION_REQUESTED는 요청이 접수되었음을 뜻하며 실행이 중지되었음을 뜻하지 않습니다. 파트너에서 이미 전송 중인 실행은 그대로 완료될 수 있으며, 완료된 파트너 생성은 누구든 수집했는지와 관계없이 과금됩니다. 따라서 실제로 무슨 일이 일어났는지 알아야 하는 호출자는 이후 상태 엔드포인트를 읽어야 하며, 여기서 효력이 발생한 취소는 다른 모든 터미널 결과와 마찬가지로 error_type을 포함한 COMPLETED로 표시됩니다. 파라미터
RouterProviderSegment
필수
표준 {provider}/{model} 모델 ID의 소문자 공급자 세그먼트로, 모델이 실행되는 파트너입니다.유형: RouterProviderSegment — 영숫자 슬러그, 예: anthropic, 최대 64자
RouterModelSegment
필수
표준 {provider}/{model} 모델 ID의 소문자 모델 세그먼트로, 해당 공급자 내에서 실행할 모델입니다.유형: RouterModelSegment — 영숫자 슬러그, 예: claude-opus-4-6, 최대 128자
RouterQueueRequestId
필수
대상으로 지정할 대기 중 요청으로, 제출 시 본문에서 반환된 request_id입니다.유형: RouterQueueRequestId — pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$, uuid, 최대 36자
응답
RouterQueueCancelResponse
수락됨: CANCELLATION_REQUESTED.본문: RouterQueueCancelResponse — 헤더: X-Comfy-Request-Id
RouterQueueCancelResponse
충돌: ALREADY_COMPLETED.본문: RouterQueueCancelResponse — 헤더: X-Comfy-Request-Id
RouterErrorResponse
잘못된 요청입니다. 오류 유형과 요청 본문을 확인하세요.본문: RouterErrorResponse — 헤더: X-Comfy-Error-Type, X-Comfy-Request-Id
RouterErrorResponse
자격 증명이 누락되었거나 유효하지 않습니다.본문: RouterErrorResponse — 헤더: X-Comfy-Error-Type, X-Comfy-Request-Id
RouterErrorResponse
이 호출자 또는 모델에는 요청이 허용되지 않습니다.본문: RouterErrorResponse — 헤더: X-Comfy-Error-Type, X-Comfy-Request-Id
RouterErrorResponse
모델 ID를 찾을 수 없습니다.본문: RouterErrorResponse — 헤더: X-Comfy-Error-Type, X-Comfy-Request-Id
RouterErrorResponse
rate_limited: 호출자의 요청 허용량이 소진되었습니다. 다음 요청을 보내기 전에 Retry-After를 기다리세요.본문: RouterErrorResponse — 헤더: X-Comfy-Error-Type, X-Comfy-Request-Id, Retry-After
RouterErrorResponse
Router를 일시적으로 사용할 수 없습니다. 백오프를 사용해 재시도하세요.본문: RouterErrorResponse — 헤더: X-Comfy-Error-Type, X-Comfy-Request-Id
RouterErrorResponse
Router 요청 수준의 실패입니다. 요청이 모델에 도달하지 않았거나, 모델 자체가 보고하지 않은 이유로 실패한 경우입니다.본문: RouterErrorResponse — 헤더: X-Comfy-Error-Type, X-Comfy-Request-Id

GET /v2/models/{provider}/{model}/requests/{request_id}/status

제출된 요청 하나의 실행 대기열 상태를 조회합니다. 폴링 엔드포인트입니다. 요청의 현재 상태만 응답하고 결과는 응답하지 않으므로, 클라이언트는 매 폴링마다 출력을 전송받지 않고도 오래 걸리는 생성을 지켜볼 수 있습니다. 결과는 이 응답이 COMPLETED를 나타낼 때 아래의 조회에서 한 번만 수집됩니다. 파라미터
RouterProviderSegment
필수
정규 {provider}/{model} 모델 ID의 소문자 공급자 세그먼트로, 모델을 실행 중인 파트너입니다.유형: RouterProviderSegment — 영숫자 슬러그, 예: anthropic, 최대 64자
RouterModelSegment
필수
정규 {provider}/{model} 모델 ID의 소문자 모델 세그먼트로, 해당 공급자 내에서 실행할 모델입니다.유형: RouterModelSegment — 영숫자 슬러그, 예: claude-opus-4-6, 최대 128자
RouterQueueRequestId
필수
대상으로 지정할 대기 중인 요청으로, 제출 시 본문에서 반환된 request_id입니다.유형: RouterQueueRequestId — pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$, uuid, 최대 36자
응답
RouterQueueStatusResponse
OK - 요청의 현재 실행 대기열 상태입니다.본문: RouterQueueStatusResponse — 헤더: X-Comfy-Request-Id, Retry-After, X-Comfy-Credits-Used, X-Comfy-Estimated-Duration-Seconds, X-Comfy-Estimated-Duration-P90-Seconds, X-Comfy-Estimate-Source
RouterErrorResponse
자격 증명이 누락되었거나 유효하지 않습니다.본문: RouterErrorResponse — 헤더: X-Comfy-Error-Type, X-Comfy-Request-Id
RouterErrorResponse
이 호출자 또는 모델에 대해 요청이 허용되지 않습니다.본문: RouterErrorResponse — 헤더: X-Comfy-Error-Type, X-Comfy-Request-Id
RouterErrorResponse
모델 ID를 찾을 수 없습니다.본문: RouterErrorResponse — 헤더: X-Comfy-Error-Type, X-Comfy-Request-Id
RouterErrorResponse
Router 요청 수준 실패로, 요청이 모델에 도달하지 않았거나 모델 자체가 보고하지 않은 이유로 실패했습니다.본문: RouterErrorResponse — 헤더: X-Comfy-Error-Type, X-Comfy-Request-Id
RouterErrorResponse
rate_limited: 호출자의 요청 허용량이 소진되었습니다. 다음 요청을 보내기 전에 Retry-After만큼 기다리십시오.본문: RouterErrorResponse — 헤더: X-Comfy-Error-Type, X-Comfy-Request-Id, Retry-After
RouterErrorResponse
Router를 일시적으로 사용할 수 없습니다. 백오프를 두고 재시도하십시오.본문: RouterErrorResponse — 헤더: X-Comfy-Error-Type, X-Comfy-Request-Id
RouterErrorResponse
Router 요청 수준 실패로, 요청이 모델에 도달하지 않았거나 모델 자체가 보고하지 않은 이유로 실패했습니다.본문: RouterErrorResponse — 헤더: X-Comfy-Error-Type, X-Comfy-Request-Id
여기의 설명은 간략합니다. 모델 선택, 검증, 재시도, 결제에 대해서는 Comfy Router API 사용하기를, 헤더 동작에 대해서는 Headers를 참조하십시오.

오류 버킷

기계가 읽을 수 있는 Router 오류 카테고리이며, X-Comfy-Error-Type 헤더로도 전송됩니다.

요청 수준 버킷

Router가 요청을 접수한 뒤 완료하지 못한 경우 발생합니다.

전송 수준 버킷

모델 호출 이전이나 그 무렵에 Router 자체에서 발생합니다.

응답 헤더

string
카탈로그 페이지 또는 항목에 대한 신선도 지시문입니다.전송 시: 200, 304
string
제공되는 스키마 문서에 대한 신선도 지시문입니다.전송 시: 200, 304
string
GET /v2/models 및 GET /v2/models/{provider}/{model}에 대해 제공되는 본문 바이트에 대한 강력한 엔티티 태그입니다.전송 시: 200, 304
string
GET /v2/models/{provider}/{model}/openapi.json에 대해 제공되는 문서 바이트에 대한 강력한 엔티티 태그입니다.전송 시: 200, 304
boolean
모델을 다시 실행한 것이 아니라 Idempotency-Key의 기록에서 이 응답이 제공된 경우 존재하며 true입니다.
integer
error_type: rate_limited가 포함된 429를 받은 뒤 다음 요청을 보내기 전에 기다릴 초입니다. 호출자의 분당 요청 허용량이 한 건을 더 받아들일 수 있을 만큼 회복되는 시간입니다.전송 시: 429
integer
변경 없이 동일한 요청을 다시 보내기 전에 기다릴 초입니다.전송 시: 503
integer
대기 중인 요청을 다음에 폴링하기 전에 기다릴 초입니다.전송 시: 200, 202
integer
동일한 Idempotency-Key로 동일한 요청을 재시도하기 전에 기다릴 초입니다.전송 시: 409, 504
string
이 실행에 든 비용을 Comfy 크레딧으로 나타낸 것으로, 청구 자체가 기준으로 삼는 것과 동일한 요금표에서 산정됩니다. 따라서 호출자는 자체 가격표가 필요 없으며, 유료 호출을 두 번 이상 거쳐 공급자에 도달한 실행에서는 마지막 호출의 값이 아니라 그 합계입니다.
RouterErrorType
실패에 대한 대략적인 기계 판독 가능 버킷으로, Router가 모든 오류 응답에 설정합니다.타입: RouterErrorType
string
status가 IN_PROGRESS일 때의 상태 조회에서만 X-Comfy-Estimated-Duration-Seconds 옆에 전송됩니다. 해당 생성 시간 추정치가 어디에서 왔는지(비용 추정치의 source와는 다름)를 나타내며, historical(최근 실행에서 측정) 또는 default(미디어 종류별 대체값으로, 기록된 최근 실행이 너무 적을 때 사용)입니다.
integer
status가 IN_PROGRESS일 때의 상태 조회에서만 X-Comfy-Estimated-Duration-Seconds 옆에 전송됩니다. 해당 생성 시간 추정치의 90번째 백분위수를 정수 초 단위로 나타냅니다.
integer
status가 IN_PROGRESS일 때의 상태 조회에서만 전송됩니다. 공급자가 요청을 수락한 뒤 생성 전체 실행에 걸리는 시간에 대한 Router의 추정치를 정수 초 단위로 나타냅니다(남은 시간이 아니며, IN_QUEUE에서 보낸 시간은 절대 포함하지 않습니다).
string
콘텐츠 정책 거부가 입력 또는 출력 중 어느 쪽에 관한 것인지 나타내는 Router 수준의 폐쇄형 어휘입니다: input, output, input_text, input_image, input_video, input_audio, output_text, output_image, output_video, output_audio.
string
이 호출에 대해 서버가 생성한 식별자로, 모든 Router 응답에 존재합니다. 성공, 4xx, 5xx 모두 마찬가지입니다. 오류 응답이야말로 사용자가 지원 요청에 인용할 id가 필요한 바로 그 순간이기 때문입니다.
string
문자열 배열을 담은 하나의 JSON 인코딩 문자열입니다. 쉼표로 분리하지 말고 JSON 파서로 디코딩하세요. 전송되는 값은 쉼표로 구분된 OpenAPI 배열이 아니라 단일 문자열이며, 각 항목은 그 자체로 쉼표를 포함하는 문장이기 때문입니다. 이 호출의 요청 본문을 변환한 결과 해당 공급자에서 하나 이상의 네이티브 필드를 정확히 표현할 수 없었을 때마다 존재하며, 누락된 각 필드와 그 이유를 명시합니다. 호출자가 model_provider로 해당 변환을 요청했든(strict_mode=false, 기본값) 자동 fallback_provider 재시도가 실행되었든 마찬가지입니다.
string
fallback_provider가 실제로 이 호출을 두 번째 공급자에 대해 재시도했고 그 재시도가 성공한 경우에만 공급자 이름과 함께 존재합니다. 최종적으로 이 호출을 처리한 공급자이며, 시도되었다가 역시 실패한 공급자는 결코 아닙니다.
string
이 호출을 처리한 Router 레그(leg)의 공급자로, 모든 성공 실행 응답에 존재합니다. 네이티브 실행에서는 모델 자체의 공급자이고, model_provider가 지정한 대체 공급자이거나, fallback_provider 재시도가 도달한 공급자입니다(후자의 경우에만 X-Comfy-Router-Fallback-Provider도 이 공급자를 명시합니다). 이는 Router가 디스패치한 레그이며 출력을 생성한 벤더와 반드시 같지는 않습니다. 네이티브 레그 내부의 프록시 수준 캐스케이드(예를 들어 vertexai Gemini 이미지 체인)는 어떤 헤더에도 이름이 나오지 않는 다른 벤더로 호출을 넘길 수 있기 때문입니다.
string
모델 공급자가 요청을 거부한 이유를 길이를 제한하고 정제하여 제시한 것입니다.
integer
이 호출에 대한 모델 공급자 자체의 HTTP 상태입니다.
integer
호출자가 현재 진행 중인 호출에 확정한 미국 달러 센트 금액입니다.
integer
호출자가 진행 중인 호출에 확정할 수 있는 파트너 지출의 상한(미국 달러 센트)입니다. 호출이 승인되는 순간부터 금액이 보류되고 해당 호출이 끝나면 해제됩니다.
integer
상한 아래에 남은 여유분(미국 달러 센트)으로, 최소 0입니다.
string
Router 모델의 모든 성공 실행에서 항상 nosniff입니다.
integer
이 호출을 거부한 게이트가 집계한, 호출자가 고비용으로 분류된 모델에 대해 보유한 동시 호출 수입니다.
integer
호출자가 동시에 보유할 수 있는 고비용 분류 모델에 대한 최대 동시 호출 수로, 동시 호출 한도의 4분의 1이며 파트너 노드 호출과 공유됩니다.
integer
호출자가 아직 시작할 수 있는 고비용 모델 호출 수입니다. 429에서는 0입니다.

실행 전 비용 예상

POST /v2/models/{provider}/{model}/estimate는 본문을 실행하지 않고 가격을 산정하며, 대기 중인 제출(POST /v2/models/{provider}/{model}/requests)은 201 응답에서 estimate와 동일한 RouterCostEstimate를 반환합니다. 두 경로 모두 Comfy의 표준 정가로 가격이 산정되지만, 공급자가 보고하는 비용으로 청구되는 모델은 예외로, 해당 모델은 공급자의 공개 가격표를 기준으로 estimated 처리됩니다. 어느 쪽도 계약 요율이나 고객별 요율을 반영하지 않습니다. 협상된 가격이 적용되는 워크스페이스에는 정가가 제시되지만 실제로는 계약 요율로 청구되며, 이때 source: exact는 해당 워크스페이스의 청구 금액이 아니라 정가 기준으로 정확하다는 의미입니다. 두 경로가 반환하는 모든 금액은 최종 청구액이 아닌 추정치입니다. 최종 금액은 워크스페이스의 사용량 및 청구 기록에 확정된 청구액입니다. 자체 공급자 키로 실행한 경우에는 Comfy가 청구하지 않습니다(아래 참조). 배포에서 추정 기능이 꺼져 있으면 해당 라우트는 error_type: not_enabled와 함께 403으로 응답하고, 제출 응답에서는 estimate가 생략됩니다. 두 경로 모두 Router가 디스패치하는 방식대로 본문의 가격을 산정하지만(model_provider 구간에 맞게 변환되고, 실제로 실행되는 작업으로 재지정됨), 제출 응답의 estimate는 사전 가격이 아닙니다. 이 값은 실행이 승인되어 대기 중 상태가 된 이후에야 도착하며, 해당 실행은 디스패치 이전에 취소되지 않는 한 청구됩니다. 카탈로그에는 여전히 가격 정보가 없습니다. 어떤 금액보다 먼저 source를 확인하십시오. 금액이 누락되었다고 해서 무료를 의미하지는 않습니다. unknown 예상치의 reason은 다음 중 하나입니다:
  • not_quotable: 실행 전에는 Router가 이 호출의 가격을 산정할 수 없습니다. 공급자가 다시 보고하는 수량으로 청구되는데 본문이 그 범위를 한정하지 않거나, 본문을 보낸 그대로 가격을 산정할 수 없기 때문입니다. 인식되지 않는 모든 reason은 not_quotable로 취급하십시오.
  • unpriced_model: 요율표가 이 요청의 가격을 산정하지 않습니다.
  • byok(대기 중 제출에만 해당): 실행이 자체 공급자 키를 사용하므로 Comfy는 이에 대해 아무것도 청구하지 않습니다.
  • pricing_unavailable(대기 중 제출에만 해당): 요청이 접수될 때 요율표를 읽을 수 없었습니다. 제출은 여전히 수락되며 실행은 평소와 같이 청구됩니다.
Router가 아직 실행 전에 가격을 산정할 수 없는 모델은 실행 전 예상치가 없는 모델에 나열되어 있습니다. 여기에 나열되지 않은 모델도 특정 본문에 대해서는 unknown을 응답할 수 있으므로, 모든 예상치에서 source를 확인하십시오. 예상치가 실패 시 안전하게 동작하는 지점:
  • 금액 산정에 요율표가 필요한데 요율표가 로드되지 않았거나 오래된 경우, /estimate는 추측 대신 503을 응답합니다. 대기 중 제출은 예상치 때문에 거부되는 일이 없으며, 대신 source: unknown과 reason: pricing_unavailable을 담습니다. 실행 전에 전혀 가격을 산정할 수 없는 호출(not_quotable)이나 자체 공급자 키를 사용하는 대기 중 제출(byok)은 요율표를 읽지 않고 응답하므로, 그 200 응답은 요율표가 최신인지에 대해 아무것도 말해주지 않습니다.
  • /estimate는 기본 실행과 마찬가지로 모델 자체의 입력 스키마에 대해 본문을 검증하므로, 모델 스키마를 통과하지 못하는 본문은 실행이 응답했을 것과 동일한 detail[] 형태를 가진 동일한 422를 받습니다. 아무것도 가격이 산정되거나 디스패치되지 않습니다.
  • 대기 중 제출의 멱등 재생(Idempotent-Replayed: true)은 estimate를 생략합니다. 원본 견적이 저장되지 않기 때문입니다.
예상치의 한계. 200 응답의 금액은 실행이 수락된다거나 정확히 그 금액이 청구된다는 약속이 아닙니다:
  • /estimate는 strict_mode나 reject_unknown_fields를 받지 않으므로 모델의 기본 계약만 검사합니다. strict_mode=true 실행이 대체 공급자 자체 스키마에서 수락하는 본문이 여기서는 422를 받을 수 있고, reject_unknown_fields=true 실행이 거부할 선언되지 않은 최상위 필드도 여기서는 가격이 산정됩니다. Anthropic Messages 모델은 예외입니다. 해당 스키마는 선언되지 않은 필드를 허용하므로 reject_unknown_fields=true 실행도 아무것도 거부하지 않으며, 예상치는 선언되지 않은 최상위 필드 tools, tool_choice, temperature, top_p, top_k, stop_sequences, metadata, thinking 및 빈 mcp_servers에 대해서만 가격을 산정합니다. 그 밖의 선언되지 않은 최상위 필드가 있으면 reason: not_quotable과 함께 unknown을 응답합니다.
  • pricing_as_of는 요율표를 가져온 시점입니다. 공급자의 공개 가격표에서 가져온 estimated 견적은 그 가격표를 읽은 날짜를 담습니다. 청구 수량을 공급자의 공개 일정표에서 예측한 뒤 요율표로 가격을 매기는 exact 또는 estimated 견적은, 해당 일정표를 읽은 날짜가 요율표보다 이르면 그 날짜를 담습니다. 요율표와 일정표 모두 읽지 않은 경우에는 예상치를 응답한 시점입니다. 이는 가격 고정이 아닙니다. 실행은 요율이 적용되는 시점에 유효한 요율로 청구됩니다.
  • /estimate는 model_provider가 지정한 레그 또는 기본 공급자의 견적을 제시합니다. fallback_provider나 strict_mode 매개변수는 받지 않습니다. 폴백 재시도가 다른 공급자에 도달한 동기 실행은 예상치가 제시하지 않았던 그 공급자의 요율로 청구되며, 실행 응답의 X-Comfy-Router-Fallback-Provider가 그런 일이 있었음을 알려줍니다. 대기 중 제출에는 폴백이 없으므로 그 estimate는 실제 실행되는 레그의 견적을 제시합니다.
  • /estimate는 항상 플랫폼 청구액의 견적을 제시합니다. 자체 공급자 키로 실행하면 Comfy는 청구하지 않지만, /estimate는 이를 감지하지 못하고 여전히 금액을 반환합니다. reason: byok를 응답하는 것은 대기 중 제출뿐입니다.
  • 달러는 반올림되지 않은 센트 값을 기준으로 소수점 이하 최대 8자리까지 표시되며, 청구 가능한 1센트 미만의 amount는 절대 0으로 표시되지 않습니다. credits는 round(amount × 211, 2)이며, 이는 X-Comfy-Credits-Used가 청구 금액에 적용하는 것과 동일한 변환입니다. 따라서 매우 작은 0이 아닌 가격에서는 credits가 0으로 반올림될 수 있습니다. 이 점이 중요할 때는 credits가 아니라 amount 또는 amount_cents를 기준으로 예산을 책정하세요. 해당 헤더는 한 번의 실행에 대한 사후 수치로 남습니다. 잔액은 Comfy 플랫폼에 있습니다.

결과 에셋

모델은 에셋 URL, 인라인 바이트, 또는 둘 다를 반환할 수 있습니다. 아래 공급자는 선택된 에셋을 Comfy 스토리지로 복사하고 해당 URL을 대체합니다. 이 동작은 모델에 따라 다르며, 이를 선택하는 요청 헤더는 없습니다. 이 수명은 URL에 서명될 때 시작되며, URL을 열 때 시작되는 것이 아닙니다. 캐시되었거나 재생된 URL은 남은 시간이 더 적을 수 있으며, 재생해도 수명이 갱신되지 않습니다. Idempotency-Key 기록은 보유한 URL보다 오래 유지될 수 있으므로, 해당 URL이 만료되기 1시간 전부터 같은 키로 재시도하면 기록된 응답 대신 409 invalid_input이 응답됩니다. 응답이 반환될 때 이미 그만큼 만료에 가까웠던 경우에는 5분 동안 재생할 수 있습니다. 에셋을 즉시 다운로드하세요. 각 행에 명시된 에셋만 복사됩니다. byteplus/seedream-* 및 byteplus/seededit-* 이미지는 BytePlus 비디오 행에 포함되지 않습니다. 복사는 해당 모델의 네이티브 공급자만 수행합니다. 대체 공급자가 처리한 실행, 즉 model_provider가 대체 공급자를 지정한 경우나 폴백 재시도가 대체 공급자에 도달한 네이티브 실행(X-Comfy-Router-Fallback-Provider로 공개됨)은 해당 공급자 자체의 URL을 반환하며, 이 URL은 공급자의 만료 정책을 따르고 복사되지 않습니다. model_provider 값 default, comfy, comfyui는 대체 공급자를 지정하지 않으므로 해당 실행은 네이티브이며 위와 같이 복사됩니다. 폴백 재시도가 다시 네이티브 공급자에 도달한 model_provider 실행도 마찬가지입니다. Veo(veo/*)는 별도의 스토리지 경로를 사용합니다. response.videos[]에서 존재하는 멤버를 읽으세요. bytesBase64Encoded는 클립을 인라인으로 담고 있으며, gcsUri는 환경이 공급자의 Comfy 스토리지 직접 쓰기에 맞게 구성된 경우 Comfy가 서명한 HTTPS 링크를 담고 있습니다. 해당 링크는 응답 시점부터 24시간 동안 유효합니다. 후자의 경우 에셋을 복사하는 대신 직접 쓰기 때문에 Veo는 재호스팅 표에 포함되지 않습니다. 다른 모델은 공급자 에셋 참조 또는 인라인 바이트를 반환합니다. 공급자 URL은 공급자의 만료 정책을 따르며, 이는 위 수명보다 훨씬 짧을 수 있고 Router 계약에 명시되어 있지 않습니다. 원본 BytePlus URL(Seedance 2.x, 옵트인). Comfy가 서버 측에서 옵트인한 워크스페이스의 경우, Seedance 2.x 결과는 복사된 URL 옆에 BytePlus 자체 URL을 content.upstream_video_url 및 content.upstream_last_frame_url에 담고, content.upstream_expires_at도 함께 담습니다. 요청 매개변수는 없으며 기본적으로 옵트인되는 워크스페이스도 없습니다. 이 URL은 생성 이후 24시간 후에 만료되며, BytePlus가 삭제하면 존재하지 않습니다. Seedance 2.5에서는 BytePlus가 각 URL의 다운로드를 100회로 제한하며, Router 자체 복사도 그중 1회를 사용합니다. 각 URL은 해당 객체에 대한 베어러 자격 증명이므로, 이를 보유한 사람은 만료될 때까지 에셋을 다운로드할 수 있습니다. 데이터 보존 안 함(제로 데이터 보존) 워크스페이스. Comfy가 제로 데이터 보존으로 구성한 워크스페이스에서는 BytePlus 결과가 Comfy 스토리지에 복사되지 않습니다. 위의 byteplus/* 비디오 행은 적용되지 않으며, content.video_url과 content.last_frame_url은 BytePlus가 전송한 그대로 반환되는 BytePlus 자체 공급자 URL입니다. 이 URL은 24시간 동안 유효하고, Seedance 2.5에서는 BytePlus가 각 URL당 다운로드를 100회로 제한하므로 에셋을 신속히 다운로드하세요. 이러한 결과는 Idempotency-Key 레코드에서 재생되지 않습니다. 복사는 에셋별 최선 노력 방식으로 수행됩니다. 복사 하나가 실패하면 해당 항목은 공급자 참조를 유지합니다. 응답에는 Comfy URL과 공급자 URL이 모두 포함될 수 있으며, 에셋별 복사 상태 필드는 명시적으로 없습니다. 생성은 여전히 성공하며 과금됩니다. 성공적으로 재호스팅된 에셋 하나로 모든 URL의 수명을 추론하지 마세요. 결과가 Comfy 호스팅인지 여부는 완료된 호출을 나중에 해당 Idempotency-Key 레코드에서 재생할 수 있는지도 결정합니다. 위의 Idempotency-Key 매개변수는 재생할 수 없을 때 재시도에 무엇이 응답되는지 설명합니다.

모델별 입력 및 출력 스키마

각 모델의 필드는 GET /v2/models/{provider}/{model}/openapi.json에서 확인할 수 있습니다. 이 호출에는 API 키가 필요합니다. 스키마가 작성된 모든 모델에 대해 동일한 문서가 이 사이트에도 인증 없이 /router-schemas/{provider}/{model}.json에서 게시됩니다. 이 복사본은 마지막 문서 업데이트 시점에 캡처한 스냅샷이므로, 두 문서가 다를 경우 엔드포인트가 우선합니다. 오퍼레이션의 requestBody는 입력 검증을 설명하고, 200 응답은 스키마가 작성된 경우 출력 형태와 미디어 타입을 설명합니다. x-comfy-input-schema-authored가 false이면 Router는 모델별 사전 검증 없이 모든 JSON 객체를 허용합니다. 공급자 요구 사항은 여전히 적용됩니다. 출력 스키마는 결과를 설명하며, Router는 반환된 공급자 페이로드를 스키마와 대조하여 검증하지 않습니다. 스키마가 작성되지 않은 출력은 application/json 대신 */*를 사용할 수 있으므로, 디코딩하기 전에 응답 콘텐츠 타입을 확인하세요.

스키마

RouterBilledWorkspace

거부된 호출이 청구했을 지갑이며, RouterErrorResponse.billed_workspace에 나타납니다. “어느 지갑이 비어 있는가?”라는 질문에 답합니다. 이는 호출자의 UI에서 현재 선택된 워크스페이스와 반드시 같지는 않으며, 팀 멤버가 개인 자격 증명을 사용하는 경우 자금이 있는 팀이 열려 있더라도 여기에는 해당 멤버의 개인 지갑이 표시됩니다. denied_reason이 있을 때만 함께 제공됩니다. 필드
string
클라우드 워크스페이스 id입니다. 레거시 레일에서는 없습니다.
string
필수
personal 또는 team입니다. 개방형 문자열이므로 다른 값은 개인으로 취급하세요.
string
호출이 클라우드 워크스페이스가 아니라 워크스페이스 이전의 Metronome 고객에게 청구되는 경우 legacy입니다. 해당 고객에게는 워크스페이스 id가 없습니다. 클라우드 워크스페이스에서는 없습니다.

RouterChargesOnPolicyRejection

이 모델에 대해 콘텐츠 정책 거부가 청구되는지 여부입니다. 알 수 없는 값은 청구될 가능성이 있는 것으로 간주하세요. 유형: string

RouterCostEstimate

이 호출에 비용이 얼마나 들지 디스패치 이전에 미리 추정한 값으로, 미국 달러 기준입니다. 디스패치 전에 Comfy의 표준 정가로 책정되며, 공급자가 보고한 비용으로 청구되는 모델의 경우에는 공급자가 공개한 가격표에서 책정됩니다. 공급자 보고 방식의 경우 source: exact는 소수의 옵트인 모델에 대해서만, 그리고 공개 가격표가 금액을 완전히 결정할 때만 반환됩니다(가격을 좌우하는 모든 필드가 명시되었거나, 금액을 바꿀 수 없는 기본값으로 남아 있는 경우). 그 밖의 모든 공급자 보고 견적은 estimated이며, 가격표만으로 완전히 결정될 수 있는 일부도 여기에 포함됩니다. 어느 쪽이든 실행이 완료된 후에는 공급자가 보고한 금액으로 청구되며, 견적된 숫자가 그대로 청구되지는 않습니다. 계약 또는 고객별 요율은 반영하지 않습니다. 협상된 가격이 있는 워크스페이스는 정가로 견적되고 계약 요율로 청구되며, 이때 source: exact는 정가 기준으로 정확하다는 뜻이지 해당 워크스페이스의 청구액이 정확하다는 뜻이 아닙니다. 최종 청구액이 아닙니다. 실제로 지불하는 금액은 워크스페이스의 사용량 및 청구 기록에 있는 정산된 청구액입니다. 실행 후에 보고되는 X-Comfy-Credits-Used는 반올림된 사후 수치이며 영수증이 아닙니다. source는 이 숫자를 얼마나 신뢰할지 알려줍니다: exact는 amount를 포함하고, free는 amount “0”(요율 카드가 이 요청을 0으로 책정)을 포함하며, estimated는 min_amount와 max_amount를 포함하고 amount는 없으며, unknown은 어느 것도 없이 reason만 포함합니다. amount가 없다고 해서 무료로 읽어서는 안 됩니다. 가격 고정이 아닙니다: pricing_as_of를 참조하세요. 필드
string
필수
exact | estimated | free | unknown; 그 밖의 값은 unknown으로 읽습니다. exact와 estimated는 모두 추정치를 나타내며, 어느 것도 최종 청구액이 아닙니다. free는 요율 카드가 이 요청을 0으로 책정한다는 뜻이므로 amount는 “0”입니다. unknown은 어떤 금액도 포함하지 않습니다.
string
필수
항상 USD입니다.
string
달러 단위의 추정 비용을 소수 문자열로 나타낸 값입니다(예: “0.04”). 소수점 이하 최대 8자리이며 지수 표기는 없습니다. 청구 가능한 1센트 미만 가격은 “0”으로 표시되지 않으며, free 견적만 “0”으로 표시됩니다. source가 exact 또는 free일 때만 존재합니다. 최종 청구액이 아닙니다. 최종 금액은 워크스페이스의 사용량 및 청구 기록에 있는 정산된 청구액입니다.
string
추정치의 하한을 달러 단위 소수 문자열로 나타낸 값입니다. 이는 추정치이며 보장된 하한이 아닙니다. 예를 들어 공급자가 요청보다 적게 반환하거나(이미지가 없는 경우 등), 추정치가 과거 호출에서 학습된 일반적인 가격이거나, 가격이 요청한 수량에 따라 꾸준히 오르지 않는 경우에는 더 적게 청구될 수 있습니다. source가 estimated일 때만 존재합니다.
string
추정치의 상한을 달러 단위 소수 문자열로 나타낸 값입니다. 이는 추정치이며 보장된 상한이 아닙니다. 예를 들어 공급자가 요청보다 많이 반환하거나(요청한 것보다 많은 이미지 등), 추정치가 과거 호출에서 학습된 것이거나, 가격이 요청한 수량에 따라 꾸준히 오르지 않는 경우에는 더 많이 청구될 수 있습니다. source가 estimated일 때만 존재합니다.
number
동일한 금액을 미국 센트 단위로 나타낸, 반올림하지 않은 산술 계산용 값입니다. amount와 함께 제공됩니다.double
number
min_amount를 미국 센트 단위로 나타낸, 반올림하지 않은 값입니다. min_amount와 함께 제공됩니다.double
number
max_amount를 미국 센트 단위로 나타낸 값입니다. max_amount와 함께 제공됩니다.double
number
플랫폼 환율($1 = 211 크레딧)을 사용해 amount를 Comfy 크레딧으로 환산한 값으로, 소수점 2자리로 반올림됩니다. exact 견적에 대해 X-Comfy-Credits-Used가 담을 것으로 예상되는 값입니다. 해당 헤더는 반올림된 사후 수치이며 영수증이 아닙니다. 워크스페이스의 사용량 및 청구 기록에 있는 정산된 청구액이 최종입니다.double
string
필수
이 견적이 대상으로 하는 공급자 레그입니다. 대기 중 제출에서는 실제로 실행될 레그입니다.
RouterModelId
필수
정규 Comfy Router 모델 ID인 {provider}/{model}입니다. POST /v2/models/{provider}/{model}에서 해당 모델을 지정하는 값과 정확히 동일하므로, 호출자는 다른 어떤 값에서도 다시 유도할 필요 없이 이 경로에 그대로 삽입할 수 있습니다. pattern은 RouterProviderSegment와 RouterModelSegment를 단일 /로 연결한 것이며, maxLength는 두 값의 길이 합에 그 구분자를 더한 값입니다.유형: RouterModelId — 모델 ID, 예: anthropic/claude-opus-4-6, 최대 193자
string
필수
이 견적을 책정한 요율 카드를 가져온 시점입니다. 이 추정치는 가격 고정이 아닙니다. 실행은 요율이 적용되는 시점에 유효한 요율로 청구되며, 이 시점의 요율로 청구되지 않습니다. 공급자의 공개 가격표에서 가져온 estimated 견적(공급자가 보고한 비용으로 청구되는 모델)은 대신 해당 가격표를 읽은 날짜를 담습니다. 청구 수량이 공급자의 공개 일정표에서 예측된 후 요율 카드로 책정되는 견적은 exact 답변이든 estimated 답변이든 해당 일정표를 읽은 날짜와 카드를 가져온 시점 중 더 이른 쪽을 담습니다(공급자가 보고한 크레딧으로 청구되는 모델이 estimated인 경우입니다). 요율 카드를 읽지 않은 경우(reason: pricing_unavailable, byok, 또는 어떤 카드로도 책정할 수 없는 not_quotable 호출)에는 이 값이 견적에 응답한 시점입니다.date-time
string
source가 unknown일 때만 표시됩니다: not_quotable (Router가 이 호출의 실행 전 가격을 책정할 수 없음: 가격은 공급자가 회신하는 내용에 따라 달라지거나, 요청 본문이 과금 대상 수량을 한정하지 않기 때문입니다), unpriced_model (요율 카드가 이 요청의 가격을 책정하지 않음), byok (대기 중 제출에만 해당: 실행에 사용자의 공급자 키가 사용되므로 Comfy는 이에 대해 비용을 청구하지 않습니다), 또는 pricing_unavailable (대기 중 제출에만 해당: 요청이 접수될 때 요율 카드를 읽을 수 없었습니다. 이는 일시적인 현상이며, 실행은 평소와 같이 과금됩니다). 다른 값은 모두 not_quotable로 해석합니다.

RouterErrorResponse

인증, 액세스, 모델 조회, 할당량, 공급자 전송 실패에 대한 오류 본문입니다. 필드
string
필수
최종 사용자에게 노출해도 안전한, 사람이 읽을 수 있는 실패 설명입니다. 기계적으로 파싱되지 않습니다. 대신 error_type으로 분기하십시오. 은퇴한 모델에 대한 model_not_found에서 후속 모델이 기록되어 있고 호출자에게 표시된다면 detail은 <id> was retired on <YYYY-MM-DD>; use <successor>로 읽히고, 그렇지 않다면 <id> was retired on <YYYY-MM-DD>로 읽히며, 일반적인 제안 목록 대신 이렇게 표시됩니다. 여기에 명시된 후속 모델은 항상 호출을 다시 지정할 수 있는 라이브 카탈로그 ID입니다. 서비스 종료 날짜가 아직 미래인 모델은 은퇴한 것이 아닙니다. 그 모델은 GET /v2/models에 계속 나열되며 그 날짜까지 계속 실행할 수 있습니다. detail의 나머지 부분과 마찬가지로 이 은퇴 문구는 표시용이며 호환성 보장을 제공하지 않습니다. 기계적으로 파싱되지 않는다는 규칙에 대한 문서화된 두 가지 예외가 있습니다. POST /v2/models/{provider}/{model}에서 409는 invalid_input 버킷을 공유하는 세 가지 무관한 조건에 대해 응답되며, 오직 detail만이 이들을 구분합니다. “this request’s image selects the edit operation”으로 시작하는 detail은 multipart model_provider 거부이고, this request resolved a BYOK credential로 시작하는 detail은 BYOK model_provider 거부입니다. 둘 다 새 Idempotency-Key로 해소되지 않습니다. 해당 경로에서 다른 모든 invalid_input 409는 키 충돌입니다. 두 접두사 모두 안정적인 계약 용어이며 매칭에 사용할 수 있습니다. 다른 어디에서도 detail로 분기하는 것이 호환성 보장을 수반하지 않습니다.
RouterErrorType
필수
X-Comfy-Error-Type 응답 헤더에도 반영되어 호출자가 본문을 파싱하지 않고 분기할 수 있게 하는, Router 실패에 대한 거칠고 기계 판독 가능한 버킷입니다. 이 집합은 스무 개 값으로 닫혀 있습니다. 여섯 개의 요청 수준 버킷 invalid_input, content_policy_violation, provider_error, provider_timeout, insufficient_credits, model_not_found와, 전송 수준의 unauthorized, forbidden, concurrency_limit_exceeded, client_disconnected, internal_error, deadline_exceeded, not_enabled, service_unavailable, rate_limited, cancelled, queue_timeout, request_not_found, queue_backlog_full, result_expired입니다. “닫혀 있다”는 것은 오늘 문서화된 집합을 뜻하며 영원히 유지되는 경계가 아닙니다. 집합은 늘어날 것으로 예상되며, 그래서 이것이 의도적으로 enum이 아닌 평범한 문자열입니다. 따라서 클라이언트는 위 목록 전체를 빠짐없이 switch하지 말고, 인식할 수 없는 값을 internal_error로 취급해야 다음에 값이 추가될 때 깨지지 않습니다.유형: RouterErrorType
string
invalid_input 거부에 대한, 길이가 제한되고 정제된 이유입니다. 동기 경로에서는 모델 공급자가 제시한 이유이며, error_type이 invalid_input이고 X-Comfy-Upstream-Status가 공급자의 4xx 또는 2xx일 때만 존재합니다. 즉 공급자가 요청을 잘못된 형식으로 거부하고 그 이유를 밝힌 경우입니다. 보통 그 상태는 4xx이고, 성공 봉투 안에서 거부된 생성을 보고하는 공급자(BytePlus의 실패한 작업 폴링은 본문에 이유가 담긴 HTTP 200입니다)에서는 2xx입니다. 그 밖의 모든 실패에서는 이 필드가 없습니다. 공급자 5xx, 전송 실패, 콘텐츠 정책 거부, Router가 자기 자신에 대해 제기한 모든 거부를 포함합니다. 그리고 이 필드는 X-Comfy-Upstream-Detail 헤더를 반영합니다. invalid_input으로 종료된 실행의 대기 중 수집(GET /v2/models/{provider}/{model}/requests/{request_id})은 첫 수집에서 같은 이유를 이 필드에 담고, 그런 다음 요청에서 이 필드를 삭제합니다. 이후 수집은 보통 같은 error_type과 detail을 이 필드 없이 응답하므로 첫 수집에서 읽어야 합니다. 그 읽기는 두 헤더 모두 보내지 않습니다. 대기 중 수집은 또한 Router가 요청을 공급자에게 보내기 전에 거부했고 그 이유를 한 문장으로 밝힐 수 있을 때 Router 자체의 이유에도 이 필드를 사용합니다. 동기 경로는 그 이유를 detail에 담아 응답합니다. 개별 필드를 지목하는 거부는 아무것도 담지 않습니다.
string
콘텐츠 정책 거부가 어떤 입력 또는 출력에 관한 것이었는지를 Router 수준의 닫힌 어휘로 나타냅니다: input, output, input_text, input_image, input_video, input_audio, output_text, output_image, output_video, output_audio. 공급자가 모달리티를 지목하지 않았을 때는 input / output 값만으로 어느 쪽인지를 나타냅니다. error_type이 content_policy_violation이고 공급자가 거부된 주체를 기계 판독 가능한 코드로 지목했을 때만 존재하며, 그 외에는 없습니다. 공급자 텍스트는 절대 아닙니다. 현재 BytePlus, Runway, BFL, Gemini, Veo, Vertex, xAI, Wan 거부와 MiniMax Router의 Nano Banana 레그의 Gemini 거부에 대해 명명되어 있습니다. 거부가 어느 쪽에 관한 것인지 밝히지 않는 공급자는 이 필드를 비워 둡니다. 이 필드는 X-Comfy-Refusal-Subject 헤더를 반영합니다.
string
파트너 노드 지출 거부에 대한 Billing의 정책 분기입니다. 청구 대상 지갑이 비어 있으면 no_funds, 자금 판독이 그렇게 말하지 않은 채 호출이 거부되면 unspecified입니다. error_type이 insufficient_credits이고 배포가 지갑 정보를 보고할 때만 존재하며, 그 외에는 없습니다. 표시 텍스트가 아닌 기계 판독 가능한 코드입니다. detail을 보여주고, 이 값으로 분기하십시오.
RouterBilledWorkspace
거부된 호출이 청구했을 지갑으로, RouterErrorResponse.billed_workspace에 있습니다. “어느 지갑이 비어 있는가?”에 답합니다. 반드시 호출자의 UI가 현재 선택한 워크스페이스는 아니며, 팀 멤버의 개인 자격 증명은 자금이 있는 팀이 열려 있는 동안에도 여기에 개인 지갑을 지목합니다. denied_reason과 함께일 때만 존재합니다.유형: RouterBilledWorkspace
string
요청이 거부된 인증 방식 - personal_api_key, team_api_key, personal_session 또는 team_session. “다른 지갑으로 과금하려면 어떤 자격 증명으로 전환해야 하나?”라는 질문에 답합니다. 이는 권한이 아니며 아무것도 부여하지 않습니다. denied_reason과 함께 있을 때만 표시됩니다.

RouterErrorType

기계가 읽을 수 있는 Router 오류 카테고리이며, X-Comfy-Error-Type 헤더로도 전송됩니다. 타입: string

RouterModelBilling

모델을 호출하기 전에 확인해야 할 청구 동작입니다. 가격이나 사용량은 포함하지 않습니다. 필드
RouterChargesOnPolicyRejection
필수
이 모델이 콘텐츠 정책상의 이유로 거부하는 호출이 그럼에도 호출자에게 청구되는지 여부입니다. 공급자마다 다르고, 그 차이는 호출 시점에는 보이지 않으며, 같은 호출에 대해 오류와 청구를 함께 본 사용자는 알 방법이 없습니다. 그래서 공급자별 속설에 맡기지 않고 호출 이전에 모델별로 명시합니다. yes인 경우 동기 라우트의 content_policy_violation 오류에 X-Comfy-Credits-Used가 포함될 수 있습니다. 공급자가 모델의 생성된 출력을 거부했고 Comfy가 그 거부된 생성에 대한 사용량을 기록한 경우 포함되며, 그 수량을 담습니다. 입력 측 거부, 동일 키 재전송(Idempotent-Replayed: true), 그리고 헤더의 소수점 두 자리로는 표시되지 않을 만큼 작은 청구에는 포함되지 않습니다. 헤더가 없는 거부는 보고되지 않는다는 것이지, 무료였다는 증거는 아닙니다.유형: RouterChargesOnPolicyRejection

RouterModelDetail

Comfy Router 모델 하나에 대한 모델별 상세 정보입니다. 카탈로그 목록에서 해당 모델에 대해 보고하는 모든 항목과, 단일 모델 라우트에서만 제공되는 모델별 필드를 포함합니다. RouterModelListEntry, RouterModelDetailFields로 구성됩니다. 유형: object

RouterModelDetailFields

모델 세부 정보 엔드포인트에서 반환되는 선택적 필드입니다. 필드
string
이 모델의 입력 및 출력 스키마를 포함한 OpenAPI 문서의 URL입니다.HTTPS URL, 예: https://api.comfy.org/v2/models/bfl/flux-2-pro/openapi.json, 최대 2048자

RouterModelId

POST /v2/models/{provider}/{model}에서 사용되는 모델 ID입니다. 유형: string, 모델 ID, 예: anthropic/claude-opus-4-6, 최대 193자

RouterModelInput

모델 입력 객체입니다. 필드와 검증에 대해서는 선택된 모델의 OpenAPI 문서를 참고하세요. 유형: object

RouterModelInputSchemaDocument

한 모델의 입력과 출력에 대한 독립형 OpenAPI 문서입니다. 유형: object

RouterModelListEntry

모델의 ID와 청구 정보입니다. 필드
RouterModelId
필수
정식 Comfy Router 모델 ID로, {provider}/{model} 형식입니다. POST /v2/models/{provider}/{model}에서 모델을 지정하는 값과 정확히 동일하므로, 호출자는 다른 곳에서 다시 유도할 필요 없이 이 값을 경로에 그대로 삽입할 수 있습니다. pattern은 RouterProviderSegment와 RouterModelSegment를 단일 /로 연결한 것이며, maxLength는 두 값의 길이 합에 해당 구분자 길이를 더한 값입니다.유형: RouterModelId — 모델 ID, 예: anthropic/claude-opus-4-6, 최대 193자
RouterProviderSegment
필수
정식 {provider}/{model} 모델 ID의 소문자 provider 세그먼트로, 대상 모델을 제공하는 파트너입니다. 호출 라우트의 provider 경로 매개변수와 카탈로그 항목의 provider 필드가 모두 이 하나의 스키마를 참조하므로, 목록에 표시되는 ID와 허용되는 ID가 서로 어긋나지 않습니다.유형: RouterProviderSegment — 영숫자 슬러그, 예: anthropic, 최대 64자
RouterModelSegment
필수
정식 {provider}/{model} 모델 ID의 소문자 model 세그먼트로, 해당 공급자 내에서 실행할 모델입니다. RouterProviderSegment와 같은 이유로 호출 라우트의 model 경로 매개변수와 카탈로그 항목의 model 필드가 이 스키마를 공유합니다.유형: RouterModelSegment — 영숫자 슬러그, 예: claude-opus-4-6, 최대 128자
RouterModelBilling
필수
호출 전에 호출자가 알아야 하는 모델별 청구 정보입니다. 가격이 아닙니다. 사용량과 비용 수치는 여기에 나타나지 않습니다.유형: RouterModelBilling
string
이 모델의 GET /v2/models/{provider}/{model}/openapi.json 문서에 대한 현재 강한 ETag입니다. 해당 읽기 요청에서 If-None-Match로 보내면 스키마가 변경되지 않은 동안 304를 받을 수 있고, 지난번에 확인한 값과 비교하면 모든 문서를 가져오지 않고도 어떤 모델의 스키마가 변경되었는지 알 수 있습니다. 이 호출자가 현재 시점에 해당 읽기 요청으로 200 응답을 받을 수 없는 경우에는 값이 없습니다. 즉, 스키마 서비스를 사용할 수 없거나, 모델의 문서를 렌더링할 수 없거나, 응답을 생성하는 동안 이 호출자에게 해당 모델이 더 이상 사용 가능하지 않게 된 경우입니다. 태그가 없는 것은 스키마 변경이 아닙니다. 현재 태그를 확인하려면 모델의 문서를 다시 읽으십시오.

RouterModelListResponse

Router 모델 카탈로그의 한 페이지입니다. 필드
array of RouterModelListEntry
필수
이 페이지에 있는 모델이며, 최대 limit개입니다.타입: RouterModelListEntry의 배열
boolean
필수
이 페이지 이후에 다른 페이지가 존재하는지 여부입니다. 이 값이 참인 동안 계속 진행하세요. data가 짧거나 비어 있다고 해서 카탈로그의 끝이라고 추론하지 마세요.
RouterPageCursor
Router 목록을 가리키는 불투명 커서입니다. 서버에서 생성되며 오직 그대로 되돌려 전달될 뿐입니다. 즉 오프셋도, 모델 ID도 아니며, 정렬되지 않고, 카탈로그가 재구축되면 안정적이지 않습니다. 따라서 커서를 파싱하거나, 값을 증가시키거나, 커서가 나온 순회를 벗어나서 저장하는 것은 모두 계약 범위를 벗어납니다. 카탈로그가 움직이는 목록이기 때문에 오프셋 대신 커서를 사용합니다. 순회 도중 항목이 추가되거나 제거되면 오프셋 순회는 조용히 항목을 건너뛰거나 반복하며, 호출자는 그런 일이 일어났는지 알 수 없습니다.타입: RouterPageCursor — next_cursor로 반환되는 불투명 커서, 1–512자
integer
필수
실제로 제공된 페이지 크기입니다. 최대값을 초과하는 limit 요청은 거부되지 않고 최대값으로 제한되므로, 이 값은 요청한 값보다 작을 수 있습니다. 페이지네이션은 보낸 값이 아니라 이 숫자를 기준으로 하세요. 그렇지 않으면 받지 못한 행이 있다고 가정하게 됩니다.1–100

RouterModelOutput

모델 결과 객체입니다. 정확한 형태는 선택된 모델의 출력 스키마를 참고하세요. 유형: object

RouterModelSegment

{provider}/{model} 모델 ID에서 모델에 해당하는 부분입니다. 유형: string. 영숫자 슬러그(예: claude-opus-4-6), 최대 128자

RouterPageCursor

불투명한 카탈로그 커서입니다. cursor로 변경 없이 그대로 전달하세요. 유형: string — next_cursor로 반환되는 불투명 커서이며, 1–512자입니다.

RouterProviderSegment

{provider}/{model} 모델 ID에서 공급자에 해당하는 부분입니다. 타입: string — 영숫자 슬러그, 예: anthropic, 최대 64자

RouterQueueCancelResponse

이 라우트가 처리한 요청을 설명하는 두 상태, 즉 202와 409에 대한 취소 요청의 응답입니다. 성공 envelope와 오류 envelope를 따로 두지 않고 두 경우 모두 하나의 body 형태를 사용하는 이유는, 둘 다 동일한 진술, 즉 취소가 발견한 내용을 나타내기 때문이며, 상태 코드마다 다른 타입을 파싱해야 하는 클라이언트는 분리에서 얻는 이점이 없습니다. Fields
RouterQueueRequestId
필수
대기 중인 Router 요청 하나의 식별자입니다. 호출자가 결과를 폴링하고, 취소하고, 수집할 때 사용하는 핸들입니다.타입: RouterQueueRequestId — pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$, uuid, 최대 36자
RouterQueueCancelStatus
필수
이 라우트가 실제로 처리한 요청을 설명하는 두 결과에 대해 취소 요청이 발견한 내용입니다. 두 결과 모두 HTTP 상태로 반영되므로 클라이언트는 어느 쪽으로든 분기할 수 있습니다.타입: RouterQueueCancelStatus

RouterQueueCancelStatus

취소 요청이 확인한 내용으로, 이 라우트가 실제로 처리한 요청을 설명하는 두 가지 결과에 대한 것입니다. 두 결과 모두 HTTP 상태로도 반영되므로 클라이언트는 둘 중 하나를 기준으로 분기할 수 있습니다. 타입: string

RouterQueuePosition

응답이 생성된 즉시, 실행 대기열에서 이 요청보다 앞에 있는 요청 수입니다. 0은 이 요청이 맨 앞에 있음을 의미합니다. 타입: integer — 최소 0

RouterQueueRequestId

대기 중인 Router 요청 하나의 식별자입니다. 호출자가 폴링하고 취소하며 결과를 수집할 때 사용하는 핸들입니다. 유형: string — pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$, uuid, 최대 36자

RouterQueueStatus

대기 중인 Router 요청의 상태입니다. 정확히 세 개의 값을 가지며, RouterErrorType과 달리 이 값은 닫힌 enum입니다. 두 스키마가 의도적으로 서로 반대 방향으로 닫혀 있기 때문입니다. RouterErrorType은 실패를 분류하며 그 집합은 늘어날 것으로 예상되므로, 인식되지 않은 버킷을 엄격하게 거부하는 생성된 클라이언트는 무언가가 이미 잘못된 바로 그때 가장 심하게 실패하게 됩니다. 이 값은 라이프사이클이며, 나중에 네 번째 상태가 추가된 라이프사이클은 enum으로 선언되었든 아니든 그것을 대상으로 작성된 모든 폴링 루프에 호환성을 깨뜨리는 변경이 됩니다. 그래서 enum으로 선언되며, 제약은 클라이언트가 볼 수 있는 곳에 명시됩니다. 타입: string

RouterQueueStatusFields

RouterQueueStatusResponse에서 URL 블록을 제외한 나머지 절반입니다. 대기 중인 요청 하나의 식별자, 현재 상태, 그리고 그 상태가 터미널이면서 실행이 성공하지 못했을 때 그 이유를 나타내는 포괄적인 분류를 담습니다. 필드
RouterQueueRequestId
필수
대기 중인 Router 요청 하나의 식별자입니다. 호출자가 폴링하고 취소하고 결과를 수집할 때 사용하는 핸들입니다.타입: RouterQueueRequestId — pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$, uuid, 최대 36자
RouterQueueStatus
필수
대기 중인 Router 요청의 상태입니다. 정확히 세 개의 값을 가지며, RouterErrorType와 달리 이것은 닫힌 enum입니다. 두 스키마가 의도적으로 서로 반대 방향으로 닫혀 있기 때문입니다. RouterErrorType은 실패를 분류하며 그 집합은 늘어날 것으로 예상되므로, 인식하지 못한 분류를 강하게 거부하는 생성된 클라이언트는 이미 무언가 잘못된 바로 그 시점에 가장 크게 실패하게 됩니다. 이쪽은 라이프사이클이며, 나중에 네 번째 상태가 추가된 라이프사이클은 enum으로 선언되었든 아니든 그것을 대상으로 작성된 모든 폴링 루프에 breaking change가 됩니다. 그래서 enum으로 선언하고, 제약을 클라이언트가 확인할 수 있는 곳에 명시합니다.타입: RouterQueueStatus
RouterQueuePosition
응답이 구성된 그 순간을 기준으로 실행 대기열에서 이 요청보다 앞에 있는 요청의 수입니다. 0이면 이 요청이 맨 앞에 있습니다.타입: RouterQueuePosition — 0 이상
RouterErrorType
성공하지 못한 COMPLETED 요청에만 존재하며, 결과 조회가 해당 실패를 반환할 때 X-Comfy-Error-Type에 붙이는 것과 동일한 포괄적 분류를 담고 있습니다. 이것이 성공한 터미널 요청과 실패했거나 취소된 요청을 구분하는 기준입니다. 두 경우 모두 별도의 터미널 상태가 존재하지 않습니다. 또한 성공 시에는 null이 아니라 아예 존재하지 않으므로, 존재 여부로 분기해야 합니다.타입: RouterErrorType

RouterQueueStatusResponse

대기 중인 요청 하나의 현재 상태로, 제출 시 반환된 것과 동일한 세 개의 URL로 구성됩니다. RouterQueueUrls, RouterQueueStatusFields를 구성합니다. 유형: object

RouterQueueSubmitFields

RouterQueueSubmitResponse에서 URL 블록이 아닌 나머지 절반입니다. 즉, 새 요청의 식별자와 해당 요청이 접수된 순간의 상태입니다. 필드
RouterQueueRequestId
필수
대기 중인 Router 요청 하나의 식별자입니다. 호출자가 폴링하고 취소하며 결과를 수집할 때 사용하는 핸들입니다.타입: RouterQueueRequestId — pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$, uuid, 최대 36자
RouterQueueStatus
필수
대기 중인 Router 요청의 상태입니다. 값은 정확히 세 가지이며, RouterErrorType과 달리 이것은 닫힌 enum입니다. 두 스키마가 의도적으로 서로 반대 방향으로 닫혀 있기 때문입니다. RouterErrorType은 실패를 분류하며 그 집합은 늘어날 것으로 예상되므로, 인식되지 않은 버킷을 강하게 거부하는 생성된 클라이언트는 이미 무언가 잘못된 바로 그 시점에 가장 크게 실패하게 됩니다. 반면 이것은 라이프사이클이며, 나중에 네 번째 상태가 추가된 라이프사이클은 enum으로 선언되었든 아니든 그것을 대상으로 작성된 모든 폴링 루프에 호환성을 깨는 변경입니다. 그래서 enum으로 선언하고, 제약을 클라이언트가 볼 수 있는 곳에 명시합니다.타입: RouterQueueStatus
RouterQueuePosition
응답이 구성된 순간을 기준으로, 이 요청보다 실행 대기열에서 앞에 있는 요청의 수입니다. 0이면 이 요청이 맨 앞에 있습니다.타입: RouterQueuePosition — 0 이상
RouterCostEstimate
이 요청에 대한 사전 비용 추정치로, 호출자에게 비용 추정치가 활성화되어 있을 때 새로 접수된 요청에 포함됩니다. 이 요청이 고정된 공급자 구간의 견적을 제시합니다(실행 대기열에는 대체 루프가 없으므로 fallback_provider는 실행되는 구간을 절대 바꾸지 않습니다). 수치를 제시할 수 없을 때도 이 항목은 source: unknown과 함께 그대로 존재하며, 제출은 추정치 때문에 실패하지 않습니다. 멱등 재생(Idempotent-Replayed: true)에서는 생략되는데, 원본 견적이 저장되지 않기 때문입니다. 이것은 추정치이며 최종 청구 금액도, 가격 고정도 아닙니다. 실행은 요금이 산정되는 시점에 유효한 요율로 청구되며, 워크스페이스의 사용량 및 청구 기록에 정산된 금액이 최종입니다.타입: RouterCostEstimate

RouterQueueSubmitResponse

실행이 실행 대기열에 승인될 때 반환되는 핸들로, 요청의 식별자와 상태에 나머지 수명 주기를 처리하는 세 개의 URL을 결합한 것입니다. RouterQueueUrls, RouterQueueSubmitFields를 구성합니다. 타입: object

RouterQueueUrls

대기 중인 요청 하나의 남은 수명을 처리하는 세 가지 URL로, 활성 핸들을 포함하는 모든 응답에서 반환되므로 클라이언트가 실행 대기열 URL을 직접 구성할 필요가 없습니다. 필드
string
필수
이 요청의 상태 조회를 위한 절대 URL입니다.URI
string
필수
이 요청의 결과를 수집하는 절대 URL입니다.URI
string
필수
취소를 요청하는 절대 URL입니다.URI

RouterValidationErrorContext

검증에 실패한 규칙에 대해 공급자가 제공한 세부 정보입니다. 유형: object

RouterValidationErrorDetail

하나의 필드 수준 검증 실패입니다. 필드
array of any
필수
문제가 된 필드의 경로이며, 가장 바깥쪽 세그먼트가 먼저 옵니다. 예를 들어 ["body", "image_url"] 또는 ["body", "images", 0]처럼 배열을 정수로 인덱싱하는 경우도 있습니다.
string
필수
이 단일 실패에 대한 사람이 읽을 수 있는 설명입니다.
string
필수
이 실패에 대한 구체적이고 기계가 읽을 수 있는 사유로, 공급자로부터 변경 없이 그대로 전달됩니다. 타입이 지정된 SDK 예외 계층이 분기하는 값이 바로 이 값이며, 응답 헤더의 error_type은 그저 이를 크게 묶은 범주일 뿐입니다.
RouterValidationErrorContext
하나의 RouterValidationErrorDetail에 대해 위반된 제한값으로, 공급자로부터 그대로 전달됩니다. 예를 들어 greater_than과 함께 오는 {"limit_value": 8}, image_too_small과 함께 오는 {"min_width": 512}, 또는 file_too_large와 함께 오는 {"max_size_bytes": 10485760} 등입니다. 키 집합은 공급자와 오류 타입에 따라 달라지므로, 이 객체는 의도적으로 열린 객체입니다. 고정된 필드 목록으로 좁히거나 msg 문자열에 합쳐 버리면, 이식된 통합이 컴파일은 되지만 제한값을 읽던 분기를 조용히 잃게 되는 바로 그 원인이 됩니다. 오류 타입에 제한값이 없으면 생략됩니다.타입: RouterValidationErrorContext
RouterValidationErrorInput
문제가 된 입력값으로, 호출자가 loc에서 다시 도출하지 않고도 무엇이 거부되었는지 볼 수 있도록 그대로 되돌려 줍니다. 문자열, 숫자, 논리값, 배열, 객체, null 등 어떤 JSON 타입이든 될 수 있으므로, 이 스키마는 객체로 좁히지 않고 의도적으로 타입을 지정하지 않은 상태로 둡니다. 공급자가 입력값을 되돌려 주지 않으면 생략됩니다.타입: RouterValidationErrorInput

RouterValidationErrorInput

공급자가 해당 값을 포함하는 경우, 거부된 입력 값입니다.

RouterValidationErrorResponse

422 검증 오류 본문입니다. 카테고리를 확인하려면 X-Comfy-Error-Type을 읽으세요. 필드
array of RouterValidationErrorDetail
필수
요청에서 발견된 모든 검증 실패이며, 문제가 있는 필드마다 항목이 하나씩 있습니다.타입: RouterValidationErrorDetail의 배열