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