홈 → 가이드 → Chatbox에서 커스텀 API 쓰기: 호스트, 경로, Claude, 이미지 생성

Chatbox에서 커스텀 API 쓰기: 호스트, 경로, Claude, 이미지 생성

Chatbox에서 커스텀 API가 틀어지는 곳은 세 군데입니다. API 호스트와 API 경로의 조합, Claude Code와 반대로 /v1이 필요한 Claude 모드, 그리고 커스텀 공급자를 아예 쓰지 않는 이미지 생성기입니다. Chatbox 1.23.5 소스를 읽고, 모든 조합을 우리 게이트웨이에서 시험하고, 실제 Chatbox 사용자가 겪은 오류를 정리했습니다.

공급자 추가

설정 → 모델 공급자를 열고 사용자 지정 공급자 추가를 누릅니다. 이름을 정하고 API 모드는 OpenAI API 호환을 고릅니다.
API 호스트에 https://apiclan.us를 넣고 API 경로는 비워 둡니다.
콘솔에서 받은 API 키를 붙여 넣습니다.
가져오기로 키가 속한 그룹의 모델을 불러오고, 확인으로 키가 작동하는지 확인합니다.

API 호스트	API 경로	Chatbox가 호출하는 주소
`https://apiclan.us`	(비움)	`/v1/chat/completions` ✓
`https://apiclan.us/v1`	`/chat/completions`	`/v1/chat/completions` ✓
`https://apiclan.us`	`/chat/completions`	`/chat/completions` ✗ 404

Chatbox는 API 경로가 비어 있을 때만 호스트에 /v1을 붙입니다. 경로를 입력하면 호스트를 그대로 쓰기 때문에 https://apiclan.us와 /chat/completions를 함께 쓰면 /v1이 빠지고 본문 없는 404가 납니다. 경로를 비우거나 호스트에 /v1을 넣으세요.

Claude 추가

방법은 두 가지이며 주소 규칙이 다릅니다:

API 모드	API 호스트	Chatbox가 호출하는 주소
OpenAI API 호환	`https://apiclan.us`	`/v1/chat/completions` ✓
Claude API 호환	`https://apiclan.us/v1`	`/v1/messages` ✓
Claude API 호환	`https://apiclan.us`	`/messages` ✗ 404

가장 간단한 방법은 OpenAI API 호환 모드의 커스텀 공급자를 하나 더 만들고 Claude 그룹 키를 넣는 것입니다. 우리가 기록한 Chatbox 요청 43건 중 29건이 이 방식으로 보낸 claude-fable-5-1이었습니다. Claude API 호환 모드를 쓰려면 Chatbox가 /messages만 붙이므로 호스트가 /v1로 끝나야 합니다. Claude Code와는 정반대로, 그쪽 ANTHROPIC_BASE_URL에는 /v1을 넣으면 안 됩니다.

Chatbox에서 이미지 생성하기

이미지 생성기에는 내장 OpenAI 공급자(와 Chatbox 자체, Gemini)만 나옵니다. 커스텀 공급자는 이미지 모델이 없도록 코드에 고정되어 있어, 선택하면 Provider doesnt support image generation 오류가 납니다.

설정 → 모델 공급자 → OpenAI를 엽니다(직접 추가한 커스텀 공급자가 아니라 내장된 것).
API 호스트를 https://api.apiclan.us로 하고 이미지 그룹에서 만든 키를 붙여 넣습니다.
모델 gpt-image-2.5를 추가하고 모델 유형을 이미지로 합니다.
이미지 생성기를 열고 gpt-image-2.5를 고릅니다.

채팅 모델은 커스텀 공급자에 그대로 두세요. 키는 하나의 그룹에 속하므로 내장 OpenAI 공급자의 이미지 키로는 GPT 채팅 모델을 쓸 수 없습니다. 여기서 api.apiclan.us를 쓰는 이유는 큰 이미지는 몇 분이 걸릴 수 있는데 기본 주소는 100초에서 응답을 끊기 때문입니다. Chatbox와 같은 형식의 시험 요청에서 1024×1024 이미지가 21초 만에 왔습니다.

실제 Chatbox 요청의 비용

2026년 10월 12일까지 30일 동안 우리 게이트웨이가 받은 Chatbox 요청 43건 전부이며, 모두 /v1/chat/completions로 스트리밍되었습니다:

모델	요청 수	첫 토큰 중앙값	메시지당 평균
`claude-fable-5-1`	29	5.2 s	$0.039
`gpt-6-astra`	8	1.4 s	$0.006
`gpt-5.6-sol`	6	7.6 s	$0.004

여기서 Claude 답변은 GPT보다 약 7배 비쌌는데, 주로 답변이 길었기 때문입니다(평균 출력 622토큰). Chatbox는 매 턴 대화 전체를 다시 보내지만, Claude에서는 요청당 평균 4,071토큰이 정가 입력이 아닌 캐시 읽기로 과금되어 긴 대화도 비용이 크게 늘지 않습니다. gpt-5.6-sol은 가장 쌌지만 답하기 전에 추론하느라 첫 토큰이 가장 늦었습니다.

실제 Chatbox 사용자가 겪은 오류

본문 없는 404 → 호스트에 /v1 없이 API 경로를 넣었거나, Claude API 호환에서 /v1이 빠졌습니다. 위 표를 보세요.
400 This model is not supported on the Chat Completions endpoint → gpt-image-2.5를 채팅 모델로 골랐습니다. 이미지 모델은 이미지 생성기에서만 작동합니다.
403 Image generation is not enabled for this group → OpenAI 공급자에 넣은 키가 이미지 그룹 키가 아닙니다.
404 model_not_found (is not supported by any configured account in this group) → 그 모델이 키의 그룹에 없습니다(한 사용자는 우리가 제공하지 않는 gpt-5.2-pro를 직접 입력했습니다). 이름을 입력하지 말고 가져오기를 쓰세요.
Provider doesnt support image generation → 이미지 생성기가 커스텀 공급자를 가리키고 있습니다. 내장 OpenAI 공급자를 쓰세요.

다른 데스크톱 클라이언트: Cherry Studio에서 커스텀 API 쓰기 · Claude Code base URL.

사용 시작하기

구독 없음, 월 최소 사용액 없음, 영업 통화 없음. USDT로 충전하고 쓴 만큼만 지불하세요 — 1 USDT는 2 크레딧의 API 잔액이 됩니다.

30초 빠른 시작 읽기

언어: English · 简体中文 · 繁體中文 · 日本語 · 한국어 · Deutsch · Français · Español · Türkçe · Português · Italiano · Bahasa Indonesia · Tiếng Việt · Bahasa Melayu · Polski · Čeština · فارسی · Русский

이 페이지의 가격은 실제 과금 데이터에서 자동으로 채워집니다. 제3자 조건은 해당 업체의 공개 문서에서 인용했습니다.