TypingMind

Models → Add custom model: 전체 Endpoint URL https://api.kunavo.com/v1/chat/completions, Bearer와 키를 포함한 Authorization 헤더, Model ID, 컨텍스트 길이를 입력합니다 — 모델마다 하나의 항목을 브라우저에서 직접 호출합니다

Models  →  Add custom model  →  Create Manually

Name                    Kunavo · Claude Sonnet 5
Model ID                claude-sonnet-5
Context Length          1000000

Authentication tab
  API Type              OpenAI Chat Completions API
  Endpoint URL          https://api.kunavo.com/v1/chat/completions
  Authentication Type   API Key via HTTP Header
    Header Key          Authorization
    Header Value        Bearer sk-kn-...

Capabilities tab        tick only what you have checked (see below)
Request Options tab     leave "Route requests via TypingMind Cloud" off

                        → Test & Save

단계별 안내

1. /app/keys에서 키를 생성해 복사하세요. 키는 한 번만 표시됩니다.
2. TypingMind에서 왼쪽 사이드바의 Models를 열고 Add custom model을 클릭하세요. Create Manually를 선택하세요. Import JSON과 Import OpenRouter는 다른 출처용입니다.
3. Name(임의의 이름), Model ID(GET /v1/models에 표시된 ID와 정확히 일치해야 합니다. 예: claude-sonnet-5), Context Length를 입력하세요. 양식에는 128000이 미리 입력되어 있습니다. TypingMind는 이 숫자를 기준으로 전송할 대화 기록의 양을 결정하므로, 모델 페이지에서 해당 모델의 실제 컨텍스트 윈도우를 확인해 설정하세요.
4. 인증 탭에서 API 유형 = OpenAI Chat Completions API를 선택하고, 전체 엔드포인트 URL을 붙여 넣은 다음 인증 유형을 HTTP 헤더를 통한 API 키로 설정합니다. 헤더 키에 Authorization를 입력하고 헤더 값에는 Bearer sk-kn-...를 입력합니다. 즉, Bearer, 공백, 키 순서입니다.
5. 기능에서 기능을 직접 선택하거나 저장 시 기능 자동 확인을 켜 두세요. 양식 설명에 따르면 저장할 때 “몇 차례 테스트 요청”을 보내며, 토큰이 몇 개 청구됩니다. 선택 사항으로 가격에 아래 표의 백만 토큰당 요금을 입력하면 TypingMind의 비용 표시가 실제 청구액과 일치합니다. 그런 다음 테스트 및 저장을 클릭합니다.
6. 모델마다 반복합니다. 사용자 지정 엔드포인트에는 공급자 단위 항목이 없습니다. Claude Sonnet, Claude Haiku, GPT 모델은 동일한 Endpoint URL과 헤더를 사용하는 별도의 사용자 지정 모델 세 개입니다.

TypingMind 모델 문서에서 확인했습니다(2026년 10월 1일 기준). 서드파티 설정은 변경될 수 있으므로, 여기의 필드 이름이 실제 화면과 다르면 이 문서가 아니라 해당 페이지를 기준으로 삼으세요.

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

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

# 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 기준이며 입력 / 출력 순서입니다.

나머지 세 가지 API 유형

실제 양식의 API Type 드롭다운에는 OpenAI Chat Completions API, OpenAI Responses API, Claude Messages API, Gemini API가 있습니다. Kunavo는 앞의 세 가지를 지원하며, 각 유형은 Endpoint URL에 해당하는 전체 경로를 입력해야 합니다.

• Claude Messages API — Endpoint URL은 https://api.kunavo.com/v1/messages입니다. TypingMind의 Claude 형식 예시에서는 x-api-key 헤더를 사용하지만, Kunavo는 이 경로에서 해당 헤더 또는 Authorization: Bearer를 허용합니다. Kunavo는 이 경로에서 Claude 계열 ID만 제공합니다.
• OpenAI Responses API — Endpoint URL은 https://api.kunavo.com/v1/responses이며, 동일한 Bearer 헤더를 사용합니다. TypingMind 문서에는 이 유형의 예제가 없으므로, 전체 경로 형식은 인용된 내용이 아니라 나머지 세 유형에서 추론한 것입니다.
• Gemini API — 이 엔드포인트용이 아닙니다. Google의 기본 요청 형식을 기대하므로, Gemini 모델은 Chat Completions 유형을 통해 사용하세요.

이것은 TypingMind API가 아닙니다

“TypingMind API”는 보통 TypingMind Teams 인스턴스(custom.typingmind.com)의 REST API를 뜻하며, 해당 채팅 인스턴스를 관리합니다. 모델 토큰을 판매하지 않으며 이 설정과는 관련이 없습니다. 사용자 지정 모델은 TypingMind가 사용자가 제공한 키로 다른 사람의 엔드포인트를 호출하는 것입니다.

별도로 청구되는 두 가지 요금

TypingMind 라이선스는 앱 사용료입니다. 사용자 지정 모델을 통해 보내는 모든 메시지는 헤더에 설정한 키의 소유자가 토큰당 요금을 청구합니다. 이 경우 선불 잔액에서 Kunavo가 청구합니다. 라이선스 요금제와 이 요금으로 한 달간 채팅할 때 드는 비용은 TypingMind 가격 및 API 비용에서 자세히 설명합니다.

테스트 및 저장에 실패하는 경우

• “POST /v1 is the base URL, not an endpoint”라는 404 (또는 URL이 호스트에서 끝나면 “Not found: /”) — Endpoint URL에 경로가 빠져 있습니다. /v1/chat/completions로 끝나야 합니다(해당 유형에서는 /v1/messages, /v1/responses). 2026년 10월 1일 이전에는 두 경우 모두 HTML 페이지를 반환했습니다.
• “No such endpoint”라는 404 — 예를 들어 /v1/chat/completion처럼 경로의 철자가 틀렸습니다. 같은 메시지에 Kunavo가 제공하는 가장 유사한 경로가 표시됩니다.
• “Not found: /chat/completions. Kunavo's API lives under /v1”라는 404 — 경로는 있지만 /v1가 없습니다. Endpoint URL이 https://api.kunavo.com/chat/completions로 되어 있습니다. 경로 앞에 /v1를 추가하세요. (2026년 10월 1일 확인. 그 전에는 같은 실수로 HTML 페이지가 반환되었습니다.)
• 401 “Missing or invalid API key” — 헤더가 잘못되었습니다. Header Key는 Authorization여야 하고 값은 Bearer 로 시작해야 합니다. 또는 키가 폐기되었을 수 있습니다.
• 모델을 사용할 수 없다는 오류 — Model ID의 표기가 GET /v1/models에 나열된 것과 다릅니다. ID는 소문자와 하이픈으로 표기됩니다.
• 브라우저 콘솔에 네트워크 또는 CORS 오류가 표시됨 — Endpoint URL이 https://api.kunavo.com인지 확인하고 웹사이트 도메인을 입력하지 않았는지 확인하세요. CORS 헤더는 API 호스트가 보냅니다.