Мы поддерживаем два типа API для AI-агентов:
- OpenAI-совместимый API — подходит для интеграции с внешними библиотеками и UI, использует стандартную структуру запросов;
- Нативный API — более простой в использовании, особенно если нужен быстрый результат без внешних зависимостей.
- AI Gateway — API для прямой работы с моделями без использования AI-агентов.
Основные отличия
|
Характеристика |
OpenAI-совместимый API |
Нативный API |
AI Gateway |
|
Объект работы |
Агент |
Агент |
Модель |
|
Формат запроса |
|
|
|
|
История сообщений |
Передается в запросе |
Сохраняется |
Передается в запросе |
|
RAG / MCP |
Есть |
Есть |
Нет |
|
Настройки модели |
Через панель управления агента |
Через параметры запроса |
Передаются в каждом запросе |
|
Выбор модели |
Ограничен агентом |
Ограничен агентом |
Любая доступная |
|
Потоковые ответы |
Поддерживаются |
Не поддерживаются |
Поддерживаются |
Какой API выбрать
Используйте OpenAI-совместимый API, если:
- Вы хотите интегрировать агента с внешними библиотеками (например, LangChain, Open WebUI);
- Уже используете OpenAI и хотите просто заменить URL;
- Важно получать usage-статистику (токены, модель);
- Требуются потоковые ответы;
- Планируете использовать мультимодальные сообщения.
Используйте нативный API, если:
- Нужна встроенная история сообщений без явной передачи контекста;
- Вы создаете простое приложение с минимальной зависимостью от сторонних библиотек;
- Важно получить ответ в простом формате;
- Требуется быстрая и легкая интеграция, например, для MVP.
Используйте AI Gateway, если:
- Нужно работать напрямую с моделями без логики агента;
- Вы реализуете собственную логику (например, RAG или маршрутизацию запросов);
- Требуется доступ к нескольким моделям через единый API;
- Вы используете OpenAI SDK и хотите переключаться между моделями без изменения кода.
Была ли статья полезна?
Ваша оценка очень важна
Пока нет комментариев