---
title: "Поддерживаемые типы API в AI-агентах"
description: "Поддерживаемые типы API в AI-агентах. Документация и инструкции по использованию и настройке облачных сервисов Timeweb Cloud."
---

# Поддерживаемые типы API

> Полный индекс документации для ИИ-агентов: [llms.txt](https://timeweb.cloud/llms.txt).

Мы поддерживаем три типа API для работы с AI-агентами и моделями:

-   [OpenAI-совместимый API](https://timeweb.cloud/docs/ai-agents/api-usage/openai-compatible-api) — подходит для интеграции с внешними библиотеками и UI, использует стандартную структуру запросов;
-   [Нативный API](https://timeweb.cloud/docs/ai-agents/api-usage/native-api) — более простой в использовании, особенно если нужен быстрый результат без внешних зависимостей.
-   [AI Gateway](https://timeweb.cloud/docs/ai-agents/api-usage/ai-gateway) — API для прямой работы с моделями без использования AI-агентов.

## Основные отличия

| **Характеристика** | **OpenAI-совместимый API** | **Нативный API** | **AI Gateway** |
| --- | --- | --- | --- |
| **Объект работы** | Агент | Агент | Модель |
| **Формат запроса** | `messages[]` | `message + parentMessageId` | `messages[], responses` |
| **История сообщений** | Передается в запросе | Сохраняется | Передается в запросе |
| **RAG / MCP** | Есть | Есть | Нет |
| **Настройки модели** | Через панель управления агента | Через параметры запроса | Передаются в каждом запросе |
| **Выбор модели** | Ограничен агентом | Ограничен агентом | Любая доступная |
| **Потоковые ответы** | Поддерживаются | Не поддерживаются | Поддерживаются |

## Какой API выбрать

Используйте OpenAI-совместимый API, если:

-   Вы хотите интегрировать агента с внешними библиотеками (например, LangChain, Open WebUI);
-   Уже используете OpenAI и хотите просто заменить URL;
-   Важно получать usage-статистику (токены, модель);
-   Требуются потоковые ответы;
-   Планируете использовать мультимодальные сообщения.

Используйте нативный API, если:

-   Нужна встроенная история сообщений без явной передачи контекста;
-   Вы создаете простое приложение с минимальной зависимостью от сторонних библиотек;
-   Важно получить ответ в простом формате;
-   Требуется быстрая и легкая интеграция, например, для MVP.

Используйте AI Gateway, если:

-   Нужно работать напрямую с моделями без логики агента;
-   Вы реализуете собственную логику (например, RAG или маршрутизацию запросов);
-   Требуется доступ к нескольким моделям через единый API;
-   Вы используете OpenAI SDK и хотите переключаться между моделями без изменения кода.