문서

Janitor AI

Janitor AI의 프록시 설정에는 기본 URL이 아니라 전체 엔드포인트 URL이 필요하며, 경로는 /chat/completions로 끝납니다. 이 필드 하나만 올바르게 입력하면 나머지는 이름, 모델 ID, 키뿐입니다.

API Settings → Proxy → Add Configuration: Proxy URL은 전체 /v1/chat/completions 경로이며 Model Name은 카탈로그 ID와 정확히 일치해야 합니다

Janitor AI · API 설정

☰ → API Settings → Proxy → + Add Configuration

  Config Name   Kunavo
  Model Name    claude-sonnet-5
  Proxy URL     https://api.kunavo.com/v1/chat/completions
  API Key       sk-kn-...

Proxy URL은 완전한 엔드포인트 URL이어야 합니다. Janitor AI 자체 안내에 따르면 URL은 /chat/completions로 끝나야 합니다. 따라서 여기에 입력할 값은 https://api.kunavo.com/v1/chat/completions이며, 코딩 도구에 붙여 넣는 기본 URL이 아닙니다. 기본 URL을 여기에 붙여 넣는 것이 "프록시가 작동하지 않음"의 흔한 원인입니다.

Model Name은 정확히 일치해야 합니다. Janitor AI는 문자열을 수정하지 않고 그대로 전송하므로, 오타나 표시 이름을 입력하면 UI에 안내 메시지가 뜨는 대신 엔드포인트에서 오류가 반환됩니다. 이 사이트의 GET /v1/models 또는 /models에서 ID를 복사하세요.

아직 키가 없나요? Kunavo 계정을 만들고, 키를 생성한 다음(키는 sk-kn-로 시작합니다) $10부터 크레딧을 추가하세요. 호출 비용은 해당 잔액에서 차감되며 실패한 호출에는 요금이 부과되지 않습니다. 그러면 대시보드가 Janitor AI 설정 화면에서 열립니다.

단계별 안내

/app/keys에서 키를 생성해 복사하세요. 키는 한 번만 표시됩니다.
아무 채팅이나 열고 상단의 ☰ 메뉴를 클릭한 다음 API Settings를 선택하세요.
Proxy를 선택한 다음 + Add Configuration을 클릭하세요.
위와 정확히 동일하게 Config Name, Model Name, Proxy URL, API Key를 입력한 다음 저장하세요.
메시지를 하나 보내세요. 답변이 오면 프록시가 작동하는 것입니다. 모델을 지정하는 오류가 나오면 Model Name 문제이고, URL을 지정하는 오류가 나오면 경로 문제입니다.

Janitor AI 자체 프록시 안내에서 확인했습니다(2026년 9월 6일 기준). 서드파티 설정은 변경될 수 있으므로, 여기의 필드 이름이 실제 화면과 다르면 이 문서가 아니라 해당 페이지를 기준으로 삼으세요.

클라이언트를 디버깅하기 전에 확인할 사항

한 번의 요청으로 문제가 엔드포인트, 키 또는 구성 파일 중 어디에 있는지 판단할 수 있습니다. 이 요청에서 JSON이 반환되면 동일한 base URL과 키가 Janitor AI에서 작동합니다.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

필드에 입력할 model id

모든 텍스트 모델은 model id로 접근할 수 있습니다. 현재 목록은 GET /v1/models이며, 가격이 포함된 카탈로그는 모델 페이지에서 확인할 수 있습니다. 요금은 토큰 100만 개당 USD 기준이며 입력 / 출력 순서입니다.

모델 ID	Kunavo 입력/출력	Janitor AI에서의 위치
`claude-sonnet-5`	$1.40 / $7.00	기본값 — 대부분이 원하는 균형
`claude-haiku-4-5`	$0.70 / $3.50	턴당 비용이 가장 저렴하고 빠름
`claude-opus-5`	$3.50 / $17.50	비용이 많이 드는 옵션입니다. 사용을 확정하기 전에 턴당 비용을 확인하세요.
`gpt-5-6-terra`	$0.70 / $4.20	대화가 길어져 컨텍스트 크기가 제약이 되는 경우

월정액 없이 선불 잔액에서 토큰별로 청구됩니다. billing을 참고하세요. 반복되는 컨텍스트(에디터나 채팅 클라이언트가 보내는 데이터의 대부분)에서는 모델 선택보다 프롬프트 캐싱이 청구액에 더 큰 영향을 줍니다.

자주 묻는 질문

Janitor AI에는 어떤 Proxy URL이 필요한가요?

기본 URL이 아니라 전체 채팅 완성 엔드포인트가 필요합니다. Janitor AI 자체 안내에는 URL이 /chat/completions로 끝나야 한다고 명시되어 있고, 완전한 경로를 예로 듭니다. 따라서 OpenAI 호환 서비스에서는 https://<host>/v1/chat/completions를 입력합니다. 다른 설정은 올바른데 프록시가 응답하지 않는 가장 흔한 이유는 기본 URL을 입력했기 때문입니다.

Janitor AI에서 사용자 지정 프록시를 어떻게 설정하나요?

채팅을 열고 ☰ 메뉴를 클릭한 다음 API Settings를 선택하고 Proxy를 선택한 뒤 + Add Configuration을 클릭하세요. Config Name, 정확한 Model Name, /chat/completions로 끝나는 Proxy URL, API Key를 입력하고 저장한 후 테스트 메시지를 보내세요. 답변이 오면 네 필드가 모두 올바른 것입니다.

Janitor AI에서 모델을 찾을 수 없다고 표시되는 이유는 무엇인가요?

Model Name이 수정되지 않은 채 엔드포인트로 전달되며 실제 모델 ID와 정확히 일치해야 하기 때문입니다. 표시 이름, 대소문자 차이, 끝에 붙은 공백은 모두 오류를 일으킵니다. 기억에 의존해 입력하지 말고 공급자의 모델 목록이나 GET /v1/models 호출 결과에서 ID를 복사하세요.

Janitor AI에서 프록시를 사용하면 비용이 드나요?

프록시 뒤에 있는 엔드포인트의 요금이 부과됩니다. Janitor AI는 프록시 사용료를 청구하지 않으며, API 공급자가 메시지마다 토큰 단위로 요금을 부과합니다. 긴 롤플레잉 대화에서는 매 턴마다 전체 대화 기록이 포함됩니다. 저렴한 모델과 프롬프트 캐싱을 지원하는 엔드포인트를 선택하면 비용을 줄일 수 있습니다.