<div><img src="https://top-fwz1.mail.ru/counter?id=3548135;js=na" style="position:absolute;left:-9999px;" alt="Top.Mail.Ru" /></div>
Managed Kubernetes — разверните готовый кластер за 5 минут →
Вход / Регистрация
На главную
25eb9e0a-a5a8-472a-ace7-940b8bd2adf0
Облачные сервисы

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

Мы поддерживаем два типа 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

Формат запроса

Массив messages[]

Поле message с parentMessageId

История сообщений

Не сохраняется, история передается в запросе.

Сохраняется между запросами (при использовании parentMessageId)

Потоковые ответы

Поддерживаются (stream: true)

Не поддерживаются

Мультимодальность

Частично реализована

Только текст

Информация об использовании

Есть (usage, model)

Отсутствует

Формат ответа

choices, usage, model, id

message, id, response_id

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

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

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

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

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