https://api.tokios.com/v1 に、API Key を sk-tok-… のキーに、Model ID を登録済みのTokiosデプロイ名に設定すると、Clineはすべてのリクエストをプライベートトンネル経由でローカルモデルに送信します。
前提条件
- ローカルモデルとペアリング済みのTokiosコネクタ — Connector install
- 登録済みのモデルデプロイ名 — Register a model
- Tokios APIキー — API Keys
- VS Code(または互換エディタ)にCline拡張機能がインストール済みであること
ClineでOpenAI Compatibleプロバイダを設定する
1
Open Cline's settings
Clineパネルのギアアイコンをクリックして Settings を開きます。
2
Select the OpenAI Compatible provider
まず API Provider のドロップダウンで OpenAI Compatible を選択します。
3
Set the Base URL
次に Base URL のフィールドに以下を入力します。
4
Set the API Key
さらに API Key のフィールドにTokiosキーを貼り付けます。
5
Set the Model ID
次に Model ID のフィールドにTokiosの デプロイ 名、つまり Models タブで登録した公開名を入力します。例:
gemma-tunnel。これはバックエンドが使用するローカル/アップストリームのモデルIDではありません。6
Set context window and max output manually
OpenAI Compatibleプロバイダはモデルの制限を自動検出しません。Clineがリクエストを正しくサイズ調整できるよう、Context Window と Max Output Tokens をデプロイのベースモデルに合わせて入力してください。
curlでは成功したがClineで400エラーが返る場合
もしcurl を使った https://api.tokios.com/v1/chat/completions へのリクエストが成功するもののClineで400が返る場合は、以下を順番に確認してください。
Base URL is the /v1 root, not the full chat/completions path
Base URL is the /v1 root, not the full chat/completions path
Clineは
/chat/completions を Base URL に入力した値に追加します。https://api.tokios.com/v1 を入力してください。フルパス(https://api.tokios.com/v1/chat/completions)を貼り付けると、Clineは二重のパスでリクエストし、Tokiosはエラーを返します。Tokiosは安定した /v1 OpenAI surfaceを提供するため、ルートで問題ありません。常に https://api.tokios.com/v1 です。Model ID doesn't match your deployment name exactly
Model ID doesn't match your deployment name exactly
この Model ID フィールドは Models タブに表示される正確な公開デプロイ名である必要があります。アップストリームモデルIDでも、タイプミスのバリエーションでもありません。名前の不一致は通常404として表面化しますが、不正なモデル文字列(余分な空白、デプロイが大文字小文字に敏感な場合の誤ったcasingなど)は400として返ることもあります。
Streaming
Streaming
Clineはデフォルトでストリーミングレスポンスをリクエストします。Tokiosは
"stream": true の /v1/chat/completions に対する標準的なOpenAI形式のSSEを返すため、これはそのまま動作するはずです。Clineが送信するリクエストパラメータをローカルバックエンドがサポートしていない場合、Tokiosがルーティング問題に気づく前にバックエンドが400として拒否することがあります。Malformed request body
Malformed request body
400はTokiosがリクエストボディ自体を処理できなかったことを報告しています。Base URLとモデルIDの両方が正しい場合、Clineの高度な設定にプロバイダ固有のオプションが残っていないか確認してください(汎用のOpenAI Compatibleバックエンドが期待しないフィールド)。
エラーリファレンス
次のステップ
ClineをTokiosに向けたら、同じBase URL、APIキー、デプロイ名が、一緒に実行する他のOpenAI互換ツールでもそのまま機能します。クライアントごとに追加のトンネルやポートフォワーディングは不要です。Compatible clients
他のサポートされるクライアントすべてのBase URLとキー設定を確認できます。
API keys
チームメートやエージェント用の
sk-tok-… キーの作成、スコープ設定、ローテーションができます。