openrouter/chat-completions의 API 레퍼런스입니다. Openrouter에서 Comfy Router를 통해 제공됩니다.
입력: 텍스트, 이미지 · 출력: 텍스트
요청 설정
내 Comfy 워크스페이스에서 키를 생성하고COMFY_API_KEY로 내보내세요. Python의 경우 pip install comfy-sdk를 실행하세요. TypeScript의 경우 npm install @comfyorg/sdk를 실행하세요. cURL은 원시 HTTP를 사용합니다.
모델 ID: openrouter/chat-completions
엔드포인트: POST https://api.comfy.org/v2/models/openrouter/chat-completions
이 모델에는 실행 가능한 요청 예제가 없습니다. 아래 입력 문서를 바탕으로 본문을 구성한 뒤, Router quickstart와 함께 사용하세요.
스키마
입력
자동 프롬프트 캐싱을 활성화합니다. 최상위 수준에서 설정하면 시스템이 요청의 마지막 캐시 가능 블록에 캐시 중단점을 자동으로 적용합니다. 현재 Anthropic Claude 모델에서 지원됩니다.
백업 공급자가 요청을 처리하도록 허용할지 여부
- true: (기본값) 기본 공급자(또는 “order”의 사용자 지정 공급자)를 사용할 수 없는 경우, 차선의 공급자를 사용합니다.
- false: 기본/사용자 지정 공급자만 사용하고, 사용할 수 없는 경우 업스트림 오류를 반환합니다.
데이터 수집 설정. 사용 가능한 모델 공급자 중 요구 사항을 충족하는 공급자가 없으면 요청에서 오류가 반환됩니다.
- allow: (기본값) 사용자 데이터를 비일시적으로 저장하고 학습에 사용할 수 있는 공급자를 허용합니다.
- deny: 사용자 데이터를 수집하지 않는 공급자만 사용합니다.
`AkashML`, `AI21`, `AionLabs`, `Alibaba`, `Ambient`, `Baidu`, `Amazon Bedrock`, `Amazon Nova`, `Anthropic`, `Arcee AI`, `AtlasCloud`, `Avian`, `Azure`, `BaseTen`, `BytePlus`, `Black Forest Labs`, `Cerebras`, `Chutes`, `Cirrascale`, `Clarifai`, `Cloudflare`, `Cohere`, `Crucible`, `Crusoe`, `DeepInfra`, `DeepSeek`, `DekaLLM`, `Featherless`, `Fireworks`, `Friendli`, `GMICloud`, `Google`, `Google AI Studio`, `Groq`, `Hyperbolic`, `Inception`, `Inceptron`, `InferenceNet`, `Ionstream`, `Infermatic`, `Io Net`, `Inflection`, `Liquid`, `Mara`, `Mancer 2`, `Minimax`, `ModelRun`, `Mistral`, `Modular`, `Moonshot AI`, `Morph`, `NCompass`, `Nebius`, `Nex AGI`, `NextBit`, `Novita`, `Nvidia`, `OpenAI`, `OpenInference`, `Parasail`, `Poolside`, `Perceptron`, `Perplexity`, `Phala`, `Recraft`, `Reka`, `Relace`, `SambaNova`, `Seed`, `SiliconFlow`, `Sourceful`, `StepFun`, `Stealth`, `StreamLake`, `Switchpoint`, `Together`, `Upstage`, `Venice`, `WandB`, `Xiaomi`, `xAI`, `Z.AI`, `FakeProvider` | string[]
무시할 공급자 슬러그 목록. 제공된 경우, 이 목록은 이 요청에 대한 계정 전체의 무시된 공급자 설정과 병합됩니다.
`AkashML`, `AI21`, `AionLabs`, `Alibaba`, `Ambient`, `Baidu`, `Amazon Bedrock`, `Amazon Nova`, `Anthropic`, `Arcee AI`, `AtlasCloud`, `Avian`, `Azure`, `BaseTen`, `BytePlus`, `Black Forest Labs`, `Cerebras`, `Chutes`, `Cirrascale`, `Clarifai`, `Cloudflare`, `Cohere`, `Crucible`, `Crusoe`, `DeepInfra`, `DeepSeek`, `DekaLLM`, `Featherless`, `Fireworks`, `Friendli`, `GMICloud`, `Google`, `Google AI Studio`, `Groq`, `Hyperbolic`, `Inception`, `Inceptron`, `InferenceNet`, `Ionstream`, `Infermatic`, `Io Net`, `Inflection`, `Liquid`, `Mara`, `Mancer 2`, `Minimax`, `ModelRun`, `Mistral`, `Modular`, `Moonshot AI`, `Morph`, `NCompass`, `Nebius`, `Nex AGI`, `NextBit`, `Novita`, `Nvidia`, `OpenAI`, `OpenInference`, `Parasail`, `Poolside`, `Perceptron`, `Perplexity`, `Phala`, `Recraft`, `Reka`, `Relace`, `SambaNova`, `Seed`, `SiliconFlow`, `Sourceful`, `StepFun`, `Stealth`, `StreamLake`, `Switchpoint`, `Together`, `Upstage`, `Venice`, `WandB`, `Xiaomi`, `xAI`, `Z.AI`, `FakeProvider` | string[]
허용할 공급자 slug 목록입니다. 제공된 경우, 이 목록은 이 요청에 대해 계정 전체에 설정된 허용 공급자 설정과 병합됩니다.
`AkashML`, `AI21`, `AionLabs`, `Alibaba`, `Ambient`, `Baidu`, `Amazon Bedrock`, `Amazon Nova`, `Anthropic`, `Arcee AI`, `AtlasCloud`, `Avian`, `Azure`, `BaseTen`, `BytePlus`, `Black Forest Labs`, `Cerebras`, `Chutes`, `Cirrascale`, `Clarifai`, `Cloudflare`, `Cohere`, `Crucible`, `Crusoe`, `DeepInfra`, `DeepSeek`, `DekaLLM`, `Featherless`, `Fireworks`, `Friendli`, `GMICloud`, `Google`, `Google AI Studio`, `Groq`, `Hyperbolic`, `Inception`, `Inceptron`, `InferenceNet`, `Ionstream`, `Infermatic`, `Io Net`, `Inflection`, `Liquid`, `Mara`, `Mancer 2`, `Minimax`, `ModelRun`, `Mistral`, `Modular`, `Moonshot AI`, `Morph`, `NCompass`, `Nebius`, `Nex AGI`, `NextBit`, `Novita`, `Nvidia`, `OpenAI`, `OpenInference`, `Parasail`, `Poolside`, `Perceptron`, `Perplexity`, `Phala`, `Recraft`, `Reka`, `Relace`, `SambaNova`, `Seed`, `SiliconFlow`, `Sourceful`, `StepFun`, `Stealth`, `StreamLake`, `Switchpoint`, `Together`, `Upstage`, `Venice`, `WandB`, `Xiaomi`, `xAI`, `Z.AI`, `FakeProvider` | string[]
순서가 지정된 공급자 slug 목록입니다. 라우터는 요청한 모델을 지원하는 이 목록의 부분집합에서 첫 번째 공급자를 사용하려고 시도하고, 사용할 수 없으면 다음 공급자로 폴백합니다. 사용 가능한 공급자가 없으면 요청은 오류 메시지와 함께 실패합니다.
선호하는 최대 지연 시간(초)입니다. 숫자(p50에 적용) 또는 백분위수별 임계값을 지정한 객체일 수 있습니다. 임계값을 초과하는 엔드포인트는 여전히 사용될 수 있지만 라우팅에서 우선순위가 낮아집니다. 폴백 모델을 사용하는 경우, 폴백 모델이 임계값을 충족하면 기본 모델 대신 사용될 수 있습니다.
선호하는 최소 처리량(초당 토큰)입니다. 숫자(p50에 적용) 또는 백분위수별 임계값을 지정한 객체일 수 있습니다. 임계값 미만인 엔드포인트는 여전히 사용될 수 있지만 라우팅에서 우선순위가 낮아집니다. 폴백 모델을 사용하는 경우, 폴백 모델이 임계값을 충족하면 기본 모델 대신 사용될 수 있습니다.
“order”가 지정되지 않은 경우 이 요청에 사용할 정렬 전략입니다. 설정하면 로드 밸런싱이 수행되지 않습니다.
관찰 가능성을 위해 관련 요청(예: 대화 또는 에이전트 워크플로)을 그룹화하기 위한 고유 식별자입니다. 요청 본문과 x-session-id 헤더 모두에 제공된 경우 본문의 값이 우선합니다. 최대 256자입니다.
관측성 및 추적을 위한 메타데이터입니다. 알려진 키(trace_id, trace_name, span_name, generation_name, parent_span_id)는 특별하게 처리됩니다. 추가 키는 구성된 브로드캐스트 대상에 사용자 지정 메타데이터로 전달됩니다.
GET /v2/models/openrouter/chat-completions/openapi.json에서 제공하는 스키마에서 생성됨. 이는 요청이 공급자에게 도달하기 이전에 호출을 검증하는 데 사용하는 것과 동일한 문서입니다.
출력
pipeline 단계의 범주형 종류입니다. 여러 plugin이 하나의 type을 공유할 수 있습니다(예: 모든 guardrail 수준 plugin이
guardrail을 출력). name 필드가 어떤 plugin이 출력했는지 구분합니다.가능한 값: guardrail, plugin, server_tools, response_healing, context_compression예시
출력
배포 전 확인
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가 현재 지원하지 않는 기능과 대신 사용할 방법.