https://api.tokios.com/v1 に、API Key を sk-tok-… キーに、Model ID を登録済みの Tokios デプロイメント名に設定すると、Cline はすべてのリクエストをプライベートなトンネル経由でローカルモデルにルーティングします。
前提条件
- ローカルモデルとペアリングされた実行中の Tokios コネクタ — 参照: コネクタのインストール
- 登録済みのモデルデプロイメント名 — 参照: モデルの登録
- Tokios API キー — 参照: API キー
- VS Code(または互換性のあるエディター)にインストールされた Cline 拡張機能
Cline で OpenAI 互換プロバイダーを設定する
1
Cline の設定を開く
Cline パネルの歯車アイコンをクリックして Settings を開きます。
2
OpenAI 互換プロバイダーを選択する
続いて、API Provider ドロップダウンで OpenAI Compatible を選択します。
3
ベース URL を設定する
次に、Base URL フィールドに以下を入力します:
4
API キーを設定する
さらに、API Key フィールドに Tokios キーを貼り付けます:
5
モデル ID を設定する
そして、Model ID フィールドに、Tokios デプロイメント名(Models タブで登録した公開名、例:
gemma-tunnel)を入力します。これは、バックエンドが使用するローカル/アップストリームモデル ID ではありません。6
コンテキストウィンドウと最大出力を手動で設定する
OpenAI 互換プロバイダーはモデルの制限を自動検出しません。Cline がリクエストを正しくサイズ調整できるように、Context Window と Max Output Tokens をデプロイメントの基盤となるモデルに合わせて入力します。
curl では成功したが Cline で 400 エラーになる場合
単純なcurl リクエストが https://api.tokios.com/v1/chat/completions に対して成功するのに、Cline で 400 エラーが返される場合は、以下の順序で確認してください:
ベース URL は /v1 ルートであり、完全な chat/completions パスではありません
ベース URL は /v1 ルートであり、完全な chat/completions パスではありません
Cline は
/chat/completions を、Base URL に入力した値の末尾に追加します。https://api.tokios.com/v1 を入力してください。完全なパス(https://api.tokios.com/v1/chat/completions)を貼り付けると、Cline はパスが重複したリクエストを送信し、Tokios はエラーを返します。Tokios は安定した /v1 OpenAI 互換のインターフェースを提供するため、ルートは明確です。常に https://api.tokios.com/v1 であり、末尾に何も追加しません。モデル ID がデプロイメント名と完全に一致しません
モデル ID がデプロイメント名と完全に一致しません
この Model ID フィールドには、Models タブに表示される正確な公開デプロイメント名を入力する必要があります。アップストリームモデル ID でも、タイプミスのある変形名でもありません。名前の不一致は通常 404 エラーとして現れますが、不正なモデル文字列(余分な空白、デプロイメントが厳密に区別する大文字小文字の違いなど)も 400 エラーとして返される場合があります。
ストリーミング
ストリーミング
Cline はデフォルトでストリーミングレスポンスをリクエストします。Tokios は
"stream": true に対して /v1/chat/completions で標準的な OpenAI 形式の SSE を返すため、これはそのまま動作するはずです。Cline が送信するリクエストパラメータがローカルバックエンドでサポートされていない場合、Tokios がルーティングの問題を検出する前に、バックエンドがそれを 400 エラーとして拒否する可能性があります。不正なリクエストボディ
不正なリクエストボディ
400 エラーは、Tokios がリクエストボディ自体を処理できなかったことを報告しています。ベース URL とモデル ID が両方とも正しい場合は、Cline の詳細設定に誤ってプロバイダー固有のオプション(一般的な OpenAI 互換バックエンドが期待しないフィールド)が含まれていないか確認してください。
エラー参照
あなたのモデル、あなたのエージェント、どこからでも
Cline が Tokios を指すように設定されると、同じベース URL、API キー、デプロイメント名が、それと同時に実行する他のすべての OpenAI 互換ツールで機能します。クライアントごとに追加のトンネルやポートフォワーディングは不要です。互換性のあるクライアント
サポートされている他のすべてのクライアントのベース URL とキー設定を確認してください。
API キー
チームメンバーやエージェント用の
sk-tok-… キーを作成、スコープ設定、ローテーションします。