协议选择
根据现有应用和需要保留的能力，选择适合的语言模型调用协议。
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 中确认端点、鉴权方式和请求字段。
- 在测试环境验证应用实际使用的普通请求、流式输出或工具调用。