OpenAI 互換クライアント
Cherry Studio などのデスクトップクライアントは、現在の版でカスタム Base URL と Key を設定できる場合、一般的な OpenAI 互換 provider として設定できます。これは手動互換手順でありベンダー固有の認定を意味しません。/v1 を使い、表示されるモデル ID だけを同期または追加して、短い会話で確認してください。
開始前
現在の公式配布元から提供されるクライアント版だけをインストールしてください。ローカル設定を変更する前にコンソールで専用 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 ごとの一覧が正であり、以前の設定、記事、クライアントの選択肢はアクセス保証ではありません。
設定
python
from openai import OpenAI
client = OpenAI(api_key="sk-your-own-key", base_url="https://ai.tavonilo.com/v1")
print(client.chat.completions.create(
model="your-console-model",
messages=[{"role": "user", "content": "Reply with connected."}],
).choices[0].message.content)確認
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 は直ちに無効化して置き換えます。