Отправьте задачу одним HTTP-запросом — получите результат, когда он готов. Текст, файлы, голос, внешние инструменты. Всё асинхронно, всё через API.
Живой пример · вставьте JWT и выберите ассистента · токен хранится только в вашей вкладке
Три шага между вашим кодом и ответом AI-ассистента.
POST /api/tasks с JWT-токеном из Aist Backend.
Укажите ассистента, входные данные — текст, файлы или голос. Получите uuid задачи мгновенно.
Agent создаёт чат и ход в Aist Backend, передаёт конфигурацию ассистента в Aist Core. Если ассистенту нужны внешние инструменты — Agent вызовет их автоматически.
Поллинг: GET /api/tasks/{uuid} — опрашивайте статус, пока задача не завершится.
Webhook: передайте callback_url при создании — Agent сам уведомит вас, как только обработка завершится.
Всё, что умеет ассистент в чате, — из вашего кода, одним API.
Задача ставится в очередь и выполняется в фоне. Ваш сервер не держит соединение — забирает результат по uuid или получает его вебхуком.
Текст, голосовые сообщения и файлы до 1 ГБ в одном запросе: PDF, таблицы, презентации, архивы, исходники, аудио и видео. Ассистент читает документы и таблицы сам.
Объявите в задаче функции своего кода (client_tools). Когда ассистенту нужны ваши данные, задача встаёт на паузу и ждёт результат — потом продолжает с того же места.
Поиск в интернете с источниками, чтение страниц, интеграции, настроенные у ассистента: он сам вызывает нужные HTTP API и встраивает ответ в результат.
Если у ассистента есть генераторы, изображения и ролики создаются прямо в задаче и приходят файлами в output — без отдельных запросов.
GET /api/assistants покажет, какие ассистенты доступны вашему токену, а их модели — какие llm_model_id можно выбрать для задачи.
Передайте turns с предыдущими ходами — ассистент продолжит разговор с полным контекстом, включая файлы из прошлых задач.
Передайте callback_url — результат придёт на ваш URL сразу по завершении, с подписью HMAC-SHA256 по callback_secret и повторами при сбоях.
Лимит одновременных задач, max_execution_time на каждую задачу, отмена ждущих задач, список своих задач. Понятные ошибки вместо сырых ответов сервера.
Чтобы от токена до работающей интеграции прошли минуты, а не дни.
Вставьте JWT — и увидите срок действия токена, лимиты, доступных ассистентов с моделями и свои задачи. В песочнице задачу можно отправить без кода, а для каждого ассистента есть готовый пример на curl, JavaScript и Python.
Открыть панель →
runTask сам опрашивает статус и проходит цикл клиентских инструментов,
загружает файлы, показывает ассистентов и лимиты. Node 18+ и браузер.
Что появилось, что поменялось в API и что исправили — в одном месте, свежее сверху.
Что нового →Agent раскрывает потенциал AI-ассистентов за пределами чат-интерфейса.
Подключите Telegram, VK или любой мессенджер. Бот отправляет сообщение пользователя в Agent, поллит статус и пересылает ответ обратно. Все возможности ассистента — включая поиск в интернете, генерацию картинок и работу с документами — доступны прямо в чате.
Обработка входящих обращений, классификация документов, генерация отчётов. Ваш бэкенд ставит задачи в очередь, Agent обрабатывает их параллельно с нужным ассистентом и возвращает структурированный результат.
Добавьте AI-функции в своё мобильное или веб-приложение без сложной инфраструктуры. Agent берёт на себя оркестрацию между вашим приложением, хранилищем ассистентов и AI-движком.
Загрузите пачку файлов или текстов, запустите одного ассистента на все задачи. Лимит одновременных задач защищает систему от перегрузки, а Horizon распределяет нагрузку между воркерами.
Ключ к API — это JWT вашего аккаунта Aist Ai. Выпустить его можно самому за пару минут, а для компании подключим вместе.
На chat.aist-ai.com по почте, телефону, VK ID или Яндекс ID. Аккаунта ещё нет — зарегистрируйтесь там же.
«Настройки» → «API-ключи»: назовите ключ и нажмите «Выпустить». Ключ показывается один раз — сразу сохраните его. Действует год, отозвать можно там же.
Покажем доступных ассистентов, лимиты и готовый код первого запроса на curl, JavaScript и Python.
Через API доступны те же ассистенты, что и в приложении, включая ваших собственных. Задачи расходуют баланс аккаунта так же, как сообщения в чате.
Подробнее — как получить доступ и как устроен токен.
Одна задача — два запроса. Ниже минимальный пример; полное описание эндпоинтов, форматов и сценариев — в документации.
Webhook, файлы, мультиход, форматы ввода и структура ответа — подробно, с примерами и справочником.
Создать задачу и забрать результат за два запроса.
Текст, файлы и голос в массиве input.
Загрузка через POST /api/files и ссылки на скачивание.
Доставка результата на callback_url и HMAC-подпись.
Продолжение диалога через массив turns[].
Поля output, messages и metadata в ответе.
Agent — мост между вашим кодом и экосистемой AIST.
API-шлюз. Принимает задачи, ставит в очередь, оркестрирует обработку, возвращает результат. Laravel 13 + Horizon.
Центральный бэкенд. Хранит пользователей, ассистентов, чаты, ходы, модели, документы, инструменты и балансы.
AI-движок. Модели Anthropic, OpenAI, Google, xAI, DeepSeek, Perplexity, Яндекса и других. Выполняет ходы и инструменты.
Middleware для чат-интерфейса. SSE-стриминг ответов в реальном времени. Работает параллельно с Agent.
REST API → Redis-очередь → Aist Backend → Aist Core → polling или webhook. Для серверных интеграций, ботов, автоматизации. Асинхронно, без UI.
Браузер → Aist Chat → Aist Backend → Aist Core → SSE-стрим. Для пользовательского чат-интерфейса. В реальном времени, с UI.
Технические детали для тех, кто будет интегрировать.
| Параметр | Значение |
|---|---|
| Аутентификация | RS256 JWT из Aist Backend; поля sub, sanctum, exp, abilities |
| Отзыв токена | 403 от Aist Backend автоматически вносит JWT в чёрный список; следующие запросы вернут 401 |
| Лимит задач | До 5 активных (pending, processing, interrupted) на пользователя; при превышении — 429. Ждущие задачи можно отменить |
| Время выполнения | max_execution_time в секундах на задачу, не больше 24 ч; по истечении задача закрывается сама |
| Таймаут принятия | Если aist-core не подтвердил приём в течение 30 с, задача автоматически переходит в failed |
| Коды ошибок задачи |
Assistant is not available — ассистент недоступен;Insufficient balance — недостаточно баланса;Token revoked — токен отозван;Context window is full … — история в turns не помещается в модель
|
| Webhook-доставка | До 5 попыток с backoff 10 с, 30 с, 60 с, 120 с; заголовки X-Task-Uuid и X-Signature (если задан callback_secret) |
| Загрузка файлов | Любого типа, до 1 ГБ |
| Стоимость | Денежные поля хода (metadata.cost и другие) всегда нулевые — стоимость через API не раскрывается |
| Хранение задач | Завершённые, упавшие и отменённые задачи доступны 30 дней, затем удаляются |
Используйте AI-кодинг ассистента для интеграции. Файл llms.txt содержит полную документацию API в формате, оптимизированном для LLM.
Claude Code, Cursor, Windsurf и другие кодинг-ассистенты могут прочитать этот файл и сразу сгенерировать рабочий интеграционный код — с аутентификацией, загрузкой файлов, поллингом и верификацией вебхуков.