他サービスから1折AIへの移行
アドレス、キー、モデル、プロトコル、機能ごとに移行し、元の設定をロールバック可能な形で保持します。
移行前に元の設定を保存してください。まず別のターミナルまたは開発環境で検証し、成功を確認してから、常用ツールや本番サービスを変更してください。
4つの設定をまとめて確認
「4つの設定をまとめて確認」というセクション| 設定 | 1折AIの書き方 | よくある見落とし |
|---|---|---|
| OpenAI Base URL | https://1zheai.com/v1 | 余分に /chat/completions を書き足す、または /v1 を漏らす |
| Anthropic Base URL | https://1zheai.com | SDKが再度 /v1 を追加する |
| APIキー | 本サイトのコンソールで作成したキー | 旧プロバイダーのキーを引き継ぐ |
| モデルID | 本サイトの /v1/models が返す完全なID | vendor/ プレフィックスや独自のサフィックスを含む名前を引き継ぐ |
元のHTTPリクエストには完全なエンドポイントパスが必要です。SDKやデスクトップツールは通常 Base URL のみを要求します。対応するツールのチュートリアルを基準にしてください。
順番に検証する
「順番に検証する」というセクションモデルリストを確認する
モデルクエリインターフェースに従って1回呼び出してください。失敗した場合は、まずアドレス、認証情報、アクセス条件を修正し、複数のビジネスパラメータを同時に調整しないでください。
最小限のテキストリクエストを成功させる
Chat Completions、Responses、Messagesのいずれかを選択します。元のクライアントが必要とするプロトコルを維持し、まずオプションパラメータを外してください。
ビジネス機能を一つずつ復元する
ストリーミング、マルチターン履歴、ツール呼び出し、および必要なその他の機能を順に検証してください。一度に1項目ずつ追加し、比較可能なエラーレスポンスを保持してください。通常のテキストが成功しても、Agentのファイル、検索、補助モデルがすべて互換であるとは限りません。
実際のリクエスト元を確認する
呼び出しログでリクエスト時刻とモデルを確認してください。設定の再読み込みが必要なターミナル、IDE、バックグラウンドサービスを再起動し、古い環境変数が引き続き使用されるのを防いでください。
環境変数の有効範囲
「環境変数の有効範囲」というセクションターミナル内の export は、現在のシェルとその後に起動する子プロセスにのみ影響します。デスクトップアプリ、コンテナ、cronジョブ、システムサービスは別の環境を使用する場合があります。実際にプログラムを実行する場所で認証情報を設定してください。
設定ファイル内の同名フィールドも環境変数を上書きする場合があります。Claude Code、Codexなどのツールはそれぞれのチュートリアルを参照し、すべてのプロバイダー変数をグローバルシェル設定に同時に詰め込まないでください。
切り替えに失敗した場合のロールバック
「切り替えに失敗した場合のロールバック」というセクション保存しておいたプロバイダー、アドレス、モデルの設定を復元し、クライアントを再起動してください。本番業務を移行している場合は、まず少数のリクエストで検証してから範囲を広げてください。アプリケーション層の設定切り替え方法を保持し、サービスを復元しやすくしてください。
機能が開放されているか不確かな場合は、モデルカタログで確認するかサポートに問い合わせてください。他のプラットフォームがEmbeddings、Batch、または特定のプロプライエタリ画像モデルを提供しているからといって、本サイトも同じサービスを提供すると仮定しないでください。
