TypingMind

Models → Add custom model：完全なEndpoint URL https://api.kunavo.com/v1/chat/completions、Bearerとキーを含むAuthorizationヘッダー、Model ID、コンテキスト長を指定 — モデルごとに1エントリを作成し、ブラウザから直接呼び出します。

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. Authenticationタブで、API Typeを「OpenAI Chat Completions API」に設定し、完全なEndpoint URLを貼り付けます。Authentication Typeには「API Key via HTTP Header」を設定し、Header KeyにAuthorizationを、Header ValueにBearer sk-kn-...を入力します。これはBearerという語、半角スペース、キーの順です。
5. Capabilitiesでは、機能を手動で選ぶか、Auto check capabilities on saveを有効にしたままにします。フォームによると、保存時に「いくつかのテストリクエスト」が送信され、少量のトークンが課金されます。任意で、下の表にある100万トークンあたりの料金をPricingに入力すると、TypingMindのコスト表示を実際の請求額に合わせられます。最後にTest & Saveをクリックします。
6. モデルごとに繰り返してください。カスタムエンドポイントにプロバイダーレベルの設定はありません。Claude Sonnet、Claude Haiku、GPTモデルは、同じEndpoint URLとヘッダーを使う3つの個別のカスタムモデルです。

TypingMindのモデルドキュメントで2026年10月1日に確認しました。サードパーティの設定は変更されます。ここに記載されたフィールド名が表示内容と一致しなくなった場合は、このページではなく、そのページを正しい情報源としてください。

クライアントをデバッグする前に確認すること

1回のリクエストで、失敗の原因がエンドポイント、キー、設定ファイルのどれかを特定できます。これがJSONを返すなら、同じベース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-..."

フィールドに入力するモデルID

すべてのテキストモデルにはモデルIDでアクセスできます。現在の一覧はGET /v1/models、価格付きのカタログはモデルページにあります。料金は100万トークンあたりのUSDで、入力 / 出力の順です。

その他の3つのAPIタイプ

実際のフォームのAPI Typeドロップダウンには、OpenAI Chat Completions API、OpenAI Responses API、Claude Messages API、Gemini APIがあります。Kunavoが対応しているのは最初の3つです。それぞれのEndpoint URLには、ルートを含む完全なURLが必要です。

• Claude Messages API — Endpoint URL https://api.kunavo.com/v1/messages。TypingMind独自のClaude形式の例ではx-api-keyヘッダーを使っています。このルートでは、KunavoはそのヘッダーとAuthorization: Bearerのどちらも受け付けます。このルートで利用できるのはClaudeファミリーのIDのみです。
• OpenAI Responses API — Endpoint URL https://api.kunavo.com/v1/responses。Bearerヘッダーは同じです。TypingMindのドキュメントにはこのタイプの実例がないため、完全なルートを指定する形式は他の3つの例からの推定であり、引用ではありません。
• Gemini API — このエンドポイントでは利用できません。Google独自のリクエスト形式を必要とするため、代わりにChat CompletionsタイプからGeminiモデルを利用してください。

これはTypingMind APIではありません

「TypingMind API」は通常、チャットインスタンスを管理するTypingMind Teamsインスタンス（custom.typingmind.com）のREST APIを指します。モデルのトークンを販売するものではなく、この設定とは関係ありません。カスタムモデルとは、TypingMindから、ユーザーが提供したキーを使って他社のエンドポイントを呼び出すものです。

請求は別々です

TypingMindのライセンス料金はアプリの利用料です。カスタムモデル経由で送信する各メッセージは、ヘッダー内のキーの所有者によってトークン単位で請求されます。ここでは、前払い残高からKunavoが請求します。ライセンスの各プランと、これらの料金で1か月チャットを利用した場合の費用については、TypingMindの料金とAPIコストで詳しく説明しています。

Test & Saveが失敗する場合

• 「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ホストです。