Cursor
Cursor の Models 設定でカスタム OpenAI 互換 provider を追加し、専用 Key と /v1 Base URL を入力して、Key の一覧にあるモデル ID だけを追加します。設定 UI はリリースで変わるため、最後に機密を含まない短い Composer リクエストで確認してください。
開始前
現在の公式配布元から提供されるクライアント版だけをインストールしてください。ローカル設定を変更する前にコンソールで専用 API Key を作成し、個人用、共有用、または本番デプロイ用の Key を使い回さないでください。
Windows、macOS、Linux
- Windows: 現在の Windows インストーラーまたは PowerShell 手順を使い、設定変更後はすべてのクライアントプロセスを終了します。
- macOS: CPU に合う署名済みアプリまたは公式ターミナルインストーラーを使います。ホームディレクトリの設定はその macOS ユーザーに属します。
- Linux / WSL: ディストリビューションまたは公式 CLI の最新手順に従います。WSL は Windows プロファイルではなく Linux のホームディレクトリを読みます。
モデルを選ぶ
専用 Key で GET /v1/models を呼び、返された data[].id を一つ選びます。Key ごとの一覧が正であり、以前の設定、記事、クライアントの選択肢はアクセス保証ではありません。
設定
text
API key: sk-your-own-key
Base URL: https://ai.tavonilo.com/v1
Model ID: copy one id from GET /v1/models確認
Key を /v1/models で確認し、機密を含まない小さなリクエストを 1 回実行します。サポートには時刻、ルート、モデル、HTTP 状態、request ID だけを残してください。タイムアウトは課金対象の生成が未処理である証拠ではないため、長い生成や画像リクエストを無条件に再送しないでください。
安全な復旧
- 401: 不完全、失効、または誤った Key を置き換えます。サポート依頼に Key を貼り付けないでください。
- 403: Key のグループ、モデル表示、残高、ルート権限を確認します。
- 404: ここに示す Base URL を使い、完全な endpoint や二重の /v1 を設定しません。
- 429: 作業をキューイングし、ある場合は Retry-After に従います。バッチを並列再送しないでください。
- 5xx / timeout: 安全に再試行できる操作だけを限定して再試行します。時刻、route、model、HTTP status、request ID を匿名化ログに残します。
認証情報の境界
端末またはワークロードごとに Key を分けます。API Key、auth.json、完全な非公開プロンプト、パスワード、認証コード、決済情報をサポートへ送らないでください。漏えいが疑われた Key は直ちに無効化して置き換えます。