Выбор протокола
Выберите протокол вызова языковых моделей с учётом существующего приложения и необходимых возможностей.
AGTCloud предоставляет несколько протоколов вызова языковых моделей. Вы можете сохранить SDK и структуру запросов существующего приложения или выбрать новый протокол с учётом необходимых возможностей.
При первом подключении начните с OpenAI Chat
Если нет требований к определённому SDK или протоколу, для первого вызова можно использовать OpenAI Chat Completions.
Что такое протокол вызова
Протокол API определяет адрес запроса, способ аутентификации, поля запроса, структуру ответа и формат потоковых событий. Протоколы используют разные структуры данных: клиент должен отправлять запросы и разбирать ответы в соответствии с выбранным протоколом.
Эта страница описывает только протоколы вызова языковых моделей, без интерфейсов для изображений, видео и аудио.
Как выбрать протокол
Протокол определяет организацию полей запроса, структуры ответа и потоковых событий, а модель — фактически используемые возможности ИИ. Выбирайте в следующем порядке:
Сохраните способ вызова существующего проекта
В существующем проекте можно продолжить использовать протокол текущего 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 вызова автоматически обновляются в соответствии с текущим сайтом:
URL запроса:
POST https://api.agtcloud.cn/v1/chat/completionsURL запроса:
POST https://api.agtcloud.cn/v1/responsesURL запроса:
POST https://api.agtcloud.cn/v1/messagesURL запроса:
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 поддерживает преобразование протоколов, но это не означает полной совместимости всех параметров.
Проверка перед подключением
- В каталоге моделей проверьте ID модели и права аккаунта.
- В соответствующем API Reference проверьте endpoint, способ аутентификации и поля запроса.
- В тестовой среде проверьте обычные запросы, потоковый вывод или вызовы инструментов, которые фактически использует приложение.