FAQ

クイックスタートに従って、アカウントへのログイン、API Keyの作成、モデルの選択、最小リクエストの送信を行います。最初のテストではOpenAI Chat互換呼び出しを使用し、基本的な接続を確認してからストリーミング出力、ツール呼び出し、マルチモーダル入力を追加することを推奨します。

まずAPI Keysを開くと、トークンを作成、無効化、削除できます。環境ごとに異なるKeyを使用し、使用しなくなったKeyや漏えいの疑いがあるKeyは速やかに無効化または削除してください。

推奨Base URLはhttps://api.agtcloud.cn/v1です。OpenAI SDKではbase_urlまたはbaseURLとして設定し、OpenAI互換インターフェースでは通常Authorization: Bearer your-api-keyを使用します。その他のプロトコルは、対応するAPI Referenceで必要な認証Headerを確認してください。詳しくはAPI Keyと認証を参照してください。

推奨しません。長期API Keyは、信頼できるサーバー、サーバー側の環境変数、またはシークレット管理サービスに保存してください。ブラウザやモバイルアプリは独自のバックエンドにリクエストし、そのバックエンドからAGTCloudを呼び出すことで、Keyの取得や不正利用を防ぎます。

Base URLにすでに/v1が含まれているのに、コードでエンドポイントの前に/v1を重ねて追加していることが一般的な原因です。SDKのBase URLにはhttps://api.agtcloud.cn/v1を使用し、/chat/completionsなどのエンドポイントはSDKに連結させてください。調査時は実際に送信された完全なURLを確認します。

現在表示されるモデルとモデルIDはモデルマーケットプレイスで確認できます。表示範囲はプラットフォーム設定とアカウント権限によって変わります。呼び出し時は現在のページに表示されたIDをコピーし、実際のリクエスト結果を確認してください。

維持する必要があるベンダー固有のプロトコル仕様がない場合は、SDKと接続方法が一般的なOpenAI Chat Completionsから始められます。既存のAnthropic、Gemini、Responsesアプリケーションがある場合は、現在のSDKとメッセージ構造を優先して維持し、対象モデルの対応状況を確認してください。

401ではプロトコルに必要な認証HeaderとAPI Keyを、403ではアカウント、Key、モデル権限を、404ではBase URL、エンドポイント、モデルID、タスクIDを確認します。これらのエラーを無制限に再試行せず、明確な原因を先に修正してください。詳しくはエラーとトラブルシューティングを参照してください。

レスポンスHeaderのx-request-id、request-id、x-oneapi-request-idを確認し、実際に存在する値を保存します。一部のエラー本文にもRequest IDが含まれる場合があります。見つからない場合でも、リクエスト時刻、Method、Path、モデル、HTTPステータスを記録してください。コード例はRequest IDを参照してください。

漏えいが疑われる場合は、すぐにAPI Keysで古いKeyを無効化または削除し、新しいKeyを作成して利用中のサービスを更新します。コードリポジトリ、ログ、スクリーンショット、チャット記録にコピーが残っていないか確認してください。Gitにコミットしたことがある場合は、現在のファイルを削除するだけでなく、チームのセキュリティ手順に従って履歴も処理します。

リクエスト日時とタイムゾーン、Method、Path、モデルID、HTTPステータス、機密情報を除いたエラーメッセージ、SDKとランタイムのバージョン、最小再現手順を準備します。レスポンスにRequest IDがある場合は併せて保存してください。完全なAPI Key、認証Header、Cookie、顧客のPrompt、非公開ファイルを送信しないでください。