協議選擇
根據現有應用和需要保留的能力，選擇適合的語言模型呼叫協議。
AGTCloud 提供多種語言模型呼叫協議。你可以沿用現有應用使用的 SDK 和請求結構，也可以根據需要的能力選擇新的協議入口。
首次串接，從 OpenAI Chat 開始
如果沒有指定的 SDK 或協議要求，可以先使用 OpenAI Chat Completions 完成首次呼叫。
什麼是呼叫協議
API 協議規定請求位址、身分驗證方式、請求欄位、回應結構和串流事件格式。不同協議使用不同的資料結構，用戶端應按照所選協議傳送請求並解析回應。
本頁只介紹語言模型呼叫協議，不包含圖片、影片和音訊介面。
如何選擇協議
協議決定請求欄位、回應結構和串流事件的組織方式，模型決定實際使用的 AI 能力。選擇時可按以下順序判斷：
沿用現有專案的呼叫方式
已有專案可以繼續使用目前 SDK 對應的協議，減少請求結構和回應解析的改動。
確認需要的能力
如果應用相依特定的內容結構、工具呼叫、推理資訊或狀態管理方式，請選擇能夠表達這些欄位的協議。
支援的協議
| 協議 | 適合的情況 | 主要結構 | 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 會根據目前站點自動更新：
呼叫 URL:
POST https://api.agtcloud.cn/v1/chat/completions呼叫 URL:
POST https://api.agtcloud.cn/v1/responses呼叫 URL:
POST https://api.agtcloud.cn/v1/messages呼叫 URL:
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 中確認端點、身分驗證方式和請求欄位。
- 在測試環境驗證應用實際使用的一般請求、串流輸出或工具呼叫。