モデル接続の問題
接続テストが失敗する
- 設定 → モデル を開き、設定を編集して 接続をテスト をクリックします。
- API キーが有効なリテラルであるか、このマシンで環境変数がエクスポートされているか確認します。
- Base URL を上書き している場合、パスセグメントの重複やプロキシの必要性を確認します。
- 企業ネットワークではベンダードメイン（例:
api.openai.com）がブロックされる場合があります。
よくあるエラー
| 症状 | 対処法 |
|---|---|
| 401 / Invalid API Key | BYOK: キーを再生成して設定を更新; Newton: 再度サインイン |
| 402 / insufficient balance | Newton: Dashboard または チャージ を開く |
| 404 / model not found | モデル ID とアカウントアクセスを確認; Newton の場合はモデルリストを更新 |
| 429 / rate limit | 同時実行数を下げるか、ベンダー/モデルを切り替え |
| タイムアウト / サービス利用不可 | ネットワーク、プロキシ、Base URL を確認; Newton は後で再試行するか BYOK に切り替え |
Newton 固有の確認
- デスクトップが Mystilink に サインイン 済みか確認（アクティベーションコードのみではない）。
- セッション期限切れの場合、再度サインインしてモデルを更新。
- 残高がゼロまたは少ない場合、先にチャージ — Newton 課金。
- ガイド: Newton LLM。
プライマリモデルが利用不可
自動フォールバック がオンの場合、少なくとも 2 つの動作する設定を維持してください。そうでなければ、一時的に別の設定を プライマリ に設定します（Newton と BYOK の切り替えも可能）。
キーの安全
- BYOK キーやアカウント認証情報を Git にコミットしたり、スクリーンショットを共有したりしないでください。
- Mystilink は BYOK キーをアップロードしません。BYOK リクエストはベンダーへ直接送信されます。
- アカウントのログイントークンを共有可能な「API キー」として扱わないでください。
詳細: Newton LLM、LLM プロバイダー、公式プラットフォーム API キー、OpenAI 互換プロバイダー、ローカルモデルデプロイ、FAQ: LLM とプライバシー。