プロトコルの選択
既存アプリケーションと維持したい機能に応じて、適切な言語モデル呼び出しプロトコルを選択します。
AGTCloudは複数の言語モデル呼び出しプロトコルを提供しています。既存アプリケーションで使用しているSDKとリクエスト構造をそのまま利用することも、必要な機能に応じて新しいプロトコルを選択することもできます。
初めて接続する場合はOpenAI Chatから始めます
指定されたSDKやプロトコル要件がない場合は、まずOpenAI Chat Completionsで最初の呼び出しを完了してください。
呼び出しプロトコルとは
APIプロトコルは、リクエストURL、認証方式、リクエストフィールド、レスポンス構造、ストリーミングイベント形式を定めます。プロトコルごとにデータ構造が異なるため、クライアントは選択したプロトコルに従ってリクエストを送信し、レスポンスを解析する必要があります。
このページでは言語モデルの呼び出しプロトコルのみを扱い、画像、動画、音声のインターフェースは含みません。
プロトコルの選び方
プロトコルはリクエストフィールド、レスポンス構造、ストリーミングイベントの構成を決め、モデルは実際に利用するAI機能を決めます。次の順序で判断してください。
既存プロジェクトの呼び出し方式を引き継ぐ
既存プロジェクトでは、現在のSDKに対応するプロトコルを継続して使用すると、リクエスト構造とレスポンス解析の変更を抑えられます。
必要な機能を確認する
アプリケーションが特定のコンテンツ構造、ツール呼び出し、推論情報、状態管理方式に依存する場合は、それらのフィールドを表現できるプロトコルを選択します。
利用可能なモデルを確認する
まずモデルマーケットプレイスで対象モデルとアカウント権限を確認し、対応するAPI Referenceに従って呼び出します。
対応プロトコル
| プロトコル | 適した用途 | 主な構造 | API Reference |
|---|---|---|---|
| OpenAI Chat Completions | 一般的な対話または既存のOpenAI Chatアプリケーション | messages、choices | Chat Completions |
| OpenAI Responses | Responsesのリクエスト構造を使用するアプリケーション | input、Response Items | OpenAI Responses |
| Anthropic Messages | Anthropic SDKまたはMessages構造を使用するアプリケーション | messages、Content Blocks | Anthropic Messages |
| Gemini Generate Content | Gemini SDKまたはContents/Parts構造を使用するアプリケーション | contents、Parts | Gemini Generate Content |
プロトコルごとにフィールド名とレスポンス構造が異なります。異なるプロトコルのフィールドを直接混在させず、選択したエンドポイントに対応するAPI Referenceに従ってリクエストを構築し、レスポンスを解析してください。
呼び出しエンドポイント
次の呼び出しURLは現在のサイトに応じて自動的に更新されます。
エンドポイント:
POST https://api.agtcloud.cn/v1/chat/completionsエンドポイント:
POST https://api.agtcloud.cn/v1/responsesエンドポイント:
POST https://api.agtcloud.cn/v1/messagesエンドポイント:
POST https://api.agtcloud.cn/v1beta/models/{model}:generateContent
一般的なケース
- 既存のOpenAI Chatプロジェクト：Chat Completionsを選択します。
- 既存のOpenAI Responsesプロジェクト：OpenAI Responsesを選択します。
- 既存のAnthropic SDKプロジェクト：Anthropic Messagesを選択します。
- 既存のGemini SDKプロジェクト：Gemini Generate Contentを選択します。
- 既存の呼び出し方式がない場合：まずChat Completionsで最小構成の呼び出しを完了します。
AGTCloudはプロトコル変換に対応していますが、プロトコル変換によってパラメータが100%完全に互換になるわけではありません。
接続前の確認
- モデルマーケットプレイスでモデルIDとアカウント権限を確認します。
- 対応するAPI Referenceでエンドポイント、認証方式、リクエストフィールドを確認します。
- テスト環境で、アプリケーションが実際に使用する通常リクエスト、ストリーミング出力、またはツール呼び出しを検証します。