커스텀 프로바이더 하나로 Chatbox에 카탈로그의 모든 모델 추가하기.

빠른 답: Model Provider 설정의 대화상자 하나.

Chatbox Settings를 열고 Model Provider 탭으로 전환하세요. Add를 클릭한 다음 Add Custom Provider를 클릭하세요. 다섯 가지 값으로 대화상자를 채우세요: Name(APIsRouter), OpenAI API Compatible로 설정한 API Mode, API Key에 여러분의 키, API Host에 https://api.apisrouter.com/v1, 그리고 API Path는 /v1로 끝나는 호스트에 대해 Chatbox가 채워주는 /chat/completions 기본값 그대로 두세요. 그다음 모델을 추가하세요. Fetch 버튼은 /v1/models를 통해 엔드포인트의 모델 목록을 가져오므로 카탈로그의 id를 바로 활성화할 수 있고, New는 짧게 엄선된 피커를 원한다면 id를 직접 입력하게 해줍니다. 키 필드 옆의 Check를 클릭하면 Chatbox가 실시간 요청을 실행합니다. 초록색 확인이 뜨면 프로바이더가 제대로 연결된 것입니다. 이 정확한 흐름을 현재 Chatbox 웹 앱에서 검증했으며, 같은 대화상자가 데스크톱과 모바일 빌드에도 제공됩니다.

Chatbox가 커스텀 프로바이더와 통신하는 방법.

Chatbox(GitHub의 chatboxai, 약 4.1만 스타)는 가장 많이 설치된 AI 채팅 클라이언트 중 하나입니다: Windows, macOS, Linux용 네이티브 앱, iOS와 Android용 모바일 빌드, 그리고 web.chatboxai.app의 브라우저 버전을 제공합니다. 각각 자체 키를 요구하는 주요 벤더의 자체 항목이 함께 제공되며, 그 밖의 모든 것을 위한 문서화된 경로가 커스텀 프로바이더 대화상자입니다. OpenAI API Compatible 모드의 커스텀 프로바이더는 엔드포인트에 대한 단순한 기술입니다: 호스트, 경로, 키, 모델 id 목록. 모든 대화 턴은 그 호스트에 대한 표준 chat-completions 요청이 되며, 피커에서 고른 모델 id가 문자열로 전달됩니다. Chatbox는 id 뒤의 모델을 어떤 벤더가 학습시켰는지 신경 쓰지 않는데, 이것이 바로 멀티 벤더 게이트웨이가 여기서 유용한 이유입니다: 프로바이더 항목 하나로 claude-sonnet-4-6, gpt-5.5, gemini-3.5-flash, deepseek-v4-flash를 같은 피커에 두고, 같은 키로 청구할 수 있습니다. 네 개의 퍼스트파티 프로바이더를 쌓아 두는 것과의 실질적인 차이는 단순히 키가 줄어드는 것만이 아닙니다. Chatbox 설정은 기기별로 동기화되므로, 벤더 계정을 추가할 때마다 휴대폰, 노트북, 웹 앱에 붙여넣을 키가 하나씩 늘어납니다. 커스텀 프로바이더 하나면 기기당 붙여넣기 한 번이면 되며, 대화를 Claude에서 DeepSeek으로 전환하는 것도 프로바이더 변경이 아니라 피커 변경이면 됩니다.

전체 설정: 대화상자의 모든 필드.

Name은 단순한 레이블일 뿐입니다. APIsRouter로 해두면 피커가 읽기 쉽게 유지됩니다. API Mode는 반드시 OpenAI API Compatible이어야 하며, 이는 Chatbox에게 표준 chat completions로 말하라고 알려줍니다. 드롭다운의 다른 모드는 Gemini 네이티브 엔드포인트용이며, 게이트웨이가 원하는 것이 아닙니다. API Host와 API Path가 합쳐져 요청 URL을 구성하며, 이 조합에서 설정이 잘못되기 쉽습니다. 호스트를 https://api.apisrouter.com/v1로 설정하면 경로는 /chat/completions가 되며, Chatbox는 /v1 호스트를 인식하면 정확히 그렇게 채워줍니다. Chatbox 문서는 호스트가 /v1을 생략하고 경로가 기본값 /v1/chat/completions가 되는 베어 호스트 관례도 설명합니다. 둘 다 같은 URL로 구성되므로, 하나의 형태를 고르고 다른 필드는 기본값 그대로 두세요. 문제가 되는 것은 이 둘을 섞는 것입니다 — /v1 호스트에 /v1/chat/completions 경로를 함께 쓰면 /v1/v1이 중복된 URL이 만들어져 404가 납니다. 필드 레이블과 자동 채우기 동작은 Chatbox 버전마다 조금씩 바뀌므로, 기억보다 구성된 URL을 믿으세요. 모델의 경우, Fetch는 수고를 덜어주는 경로입니다: Chatbox가 엔드포인트가 제공하는 모든 것을 나열하면 원하는 것을 토글로 켜면 됩니다. New는 엄선하는 경로입니다: id를 직접 입력하면 피커가 짧게 유지됩니다. 각 모델 행에는 기능 스위치(비전, 툴 사용)가 있습니다. 모델이 그 기능을 지원한다고 확실히 알지 못하면 꺼두세요 — 설정하지 않은 모델은 일반 텍스트로 취급되며, 이것이 안전한 기본값입니다. Check로 마무리한 다음, 대화를 시작해 새 프로바이더 이름 아래에서 모델을 선택하세요.

Name:      APIsRouter
API Mode:  OpenAI API Compatible
API Key:   sk-YOUR-APISROUTER-KEY
API Host:  https://api.apisrouter.com/v1
API Path:  /chat/completions   (autofilled)

Models: Fetch (pull the catalog) or New (type ids)
Then:   Check → green confirmation

일상용 채팅 클라이언트를 위한 모델 선택.

활성화한 모든 모델이 키 하나로 청구되므로, 두 id를 비교하는 것은 계정 결정이 아니라 피커 전환일 뿐입니다. 며칠간 같은 종류의 대화를 둘 다에서 돌려본 다음, APIsRouter 콘솔의 모델별 지출을 확인하고 제 몫을 한 쪽을 남기세요.

• 일상적인 질문과 빠른 재작성은 짧고 잦은 작업입니다. claude-haiku-4-5-20251001과 gemini-3.5-flash는 앱이 즉각적으로 느껴질 만큼 빠르게 답하며, 대부분의 일상 트래픽을 잘 감당합니다.
• 긴 초안 작성, 신중한 추론, 코드 논의에는 claude-sonnet-4-6이나 gpt-5.5가 제 몫을 합니다. 각 티어에서 하나씩 활성화해 두고, 프로바이더 단위가 아니라 대화 단위로 전환하세요.
• Chatbox가 항상 열어두는 사이드바라면 deepseek-v4-flash가 물량용 선택입니다. 끊임없는 짧은 대화들이 쌓이며, 빠른 티어를 쓰면 잔액이 천천히 줄어듭니다.
• 이미지 입력 대화에는 비전을 지원하는 id가 필요하며, 해당 모델 행에서 vision 스위치를 켜야 합니다. 스위치를 켜기 전에 모델 문서에서 기능을 확인하세요.
• 모든 것을 가져오기보다 몇 개의 모델을 의도적으로 활성화하세요: 토글 하나하나가 피커의 행이 되며, 나중에 다른 id를 추가하는 것은 10초짜리 수정입니다.

사용한 만큼 지불 · 공식 요금보다 저렴

Selected models are priced below official list prices. Exact input, output, cache, and per-request prices are shown for each model.

Chatbox 특유의 실패 패턴.

경로 중복이 고전적인 문제입니다. 모든 메시지에서 404가 난다면 API Host와 API Path 둘 다 /v1을 담고 있거나, 경로가 호스트의 끝부분을 반복하고 있다는 뜻입니다. 프로바이더 항목을 열어 두 필드를 하나의 URL로 읽어보세요. Fetch에서 빈 결과가 나온다면 대개 키가 잘못됐거나 없다는 뜻입니다. 모델 목록 조회 자체가 인증이 필요한 요청이기 때문입니다. API Key 필드를 확인하고, 인증 오류를 바로 보여주는 Check 버튼을 사용하세요. 일부 대화에서만 오류가 나는 모델은 대개 기능 스위치 문제입니다: 이미지 입력을 지원하지 않는 모델에서 vision이 켜져 있거나, 툴에 의존하는 흐름이 tools가 꺼진 모델에서 실행되는 경우입니다. 모델 행을 기본값으로 되돌리고 기능을 하나씩 다시 켜보세요. 그리고 프로바이더 항목은 설치본별로 존재한다는 것을 기억하세요. 데스크톱에 APIsRouter를 추가해도 휴대폰에는 설정되지 않습니다. 휴대폰에서 대화상자를 반복하거나, 버전이 지원한다면 Chatbox 자체의 설정 공유 기능을 사용하세요. 절대 반복할 필요가 없는 것은 벤더 가입입니다. 키 하나가 모든 기기의 모든 모델을 처리하기 때문입니다.

어떤 사람들이 게이트웨이를 통해 Chatbox를 쓰는가.

• 네 개의 벤더 계정과 세 기기에 걸친 네 개의 키를 유지하지 않고도 Claude, GPT, Gemini, DeepSeek을 하나의 피커에 두고 싶은 사람들.
• 일부 벤더 가입이 까다로운 지역의 사용자. 카드 없이 충전만으로 접근할 수 있어 프로바이더별 의존성이 사라집니다.
• 이미 에디터와 터미널 도구를 게이트웨이로 라우팅하고 있으며 채팅 클라이언트도 같은 키와 같은 사용량 로그로 관리하고 싶은 개발자.
• 프로젝트를 하나로 정하기 전에 실제 대화에서 id를 비교하는 모델 쇼퍼 — 각 후보는 계정이 아니라 피커의 행이면 됩니다.
• 여기저기 흩어진 구독 대신 엔드포인트 하나, 잔액 하나, 키별 사용량 가시성으로 표준화하는 가정이나 소규모 팀.

엔드포인트 검증 및 첫 메시지 디버깅.

먼저 Chatbox 밖에서 게이트웨이 쪽을 검증하세요: 키로 모델 목록을 조회한 다음, 활성화할 id로 chat completion 하나를 실행해 보세요. 둘 다 성공하면, 남은 문제는 모두 프로바이더 대화상자에 있습니다. Chatbox 안에서는 Check 버튼이 가장 빠른 신호입니다. 인증 오류는 키 필드 문제입니다. 전송 시 not-found 오류는 id 불일치이며, 대개 손으로 입력한 New 항목에서 발생합니다. 기억이 아니라 /v1/models 출력에서 id를 복사하세요. 모든 요청에서의 404는 위에서 다룬 호스트/경로 구성 문제입니다. 메시지가 순조롭게 흐르면, APIsRouter 콘솔이 요청별 모델, 토큰 수, 지출을 보여줍니다. 채팅 클라이언트는 하루 종일 작은 요청을 많이 만들어내며, 사용량 로그는 그 습관이 실제로 읽을 수 있는 모델별·일별 숫자로 바뀌는 곳입니다.

curl -s https://api.apisrouter.com/v1/models \
  -H "Authorization: Bearer $APISROUTER_API_KEY" | head -50

curl -s https://api.apisrouter.com/v1/chat/completions \
  -H "Authorization: Bearer $APISROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-haiku-4-5-20251001",
       "messages":[{"role":"user","content":"ping"}]}'

자주 묻는 질문