Мы поддерживаем два типа API для AI-агентов:
- OpenAI-совместимый API — подходит для интеграции с внешними библиотеками и UI, использует стандартную структуру запросов;
- Нативный API — более простой и легкий в использовании, особенно если нужен быстрый результат без внешних зависимостей.
Примеры запросов
OpenAI-совместимый API
Пример запроса:
POST https://api.timeweb.cloud/api/v1/cloud-ai/agents/{{agent_id}}/v1/chat/completions
Authorization: Bearer {{token}}
Content-Type: application/json
{
"model": "gpt-4",
"messages": [
{
"role": "user",
"content": "Привет"
}
],
"temperature": 1,
"max_tokens": 100,
"stream": false
}
Пример ответа:
{
"choices": [
{
"message": {
"role": "assistant",
"content": "Привет! Чем могу помочь?"
}
}
],
"usage": {
"prompt_tokens": 12,
"completion_tokens": 14,
"total_tokens": 26
}
}
Нативный API
Пример запроса:
POST https://api.timeweb.cloud/api/v1/cloud-ai/agents/{{agent_id}}/call
Authorization: Bearer {{token}}
Content-Type: application/json
{
"message": "Привет",
"parentmessageid": "3adfea84-bcdb-44b5-8914-92035e75ec24"
}
Пример ответа:
{
"message": "Привет! Чем могу помочь?",
"id": "340b7381-2834-4b98-a51c-e68f8d0abd5b",
"response_id": "ed08981f-126b-49e7-856d-d122b3a53f26"
}
Основные отличия
Характеристика |
OpenAI-совместимый API |
Нативный API |
Формат запроса |
Массив |
Поле |
История сообщений |
Не сохраняется, история передается в запросе. |
Сохраняется между запросами (при использовании |
Потоковые ответы |
Поддерживаются ( |
Не поддерживаются |
Мультимодальность |
Частично реализована |
Только текст |
Информация об использовании |
Есть ( |
Отсутствует |
Формат ответа |
|
|
Какой API выбрать
Используйте OpenAI-совместимый API, если:
- Вы хотите интегрировать агента с внешними библиотеками (например, LangChain, Open WebUI);
- Уже используете OpenAI и хотите просто заменить URL;
- Важно получать usage-статистику (токены, модель);
- Требуются потоковые ответы;
- Планируете использовать мультимодальные сообщения.
Используйте нативный API, если:
- Нужна встроенная история сообщений без явной передачи контекста;
- Вы создаете простое приложение с минимальной зависимостью от сторонних библиотек;
- Важно получить ответ в простом формате;
- Требуется быстрая и легкая интеграция, например, для MVP.
Была ли статья полезна?
Ваша оценка очень важна
Пока нет комментариев