> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.beatapi.io/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.beatapi.io/_mcp/server. # Модели и возможности > Какие модели и форматы доступны в BeatAPI, какие методы намеренно не поддерживаются и почему ответ API отличается от готового чата. # Модели и возможности ## Что предоставляет BeatAPI? | Категория | Возможности | | ---------------- | ---------------------------------------------------------------------------------- | | Текст | Двенадцать семейств моделей с одним ключом; см. [Text API](/text-api) | | Изображения | Асинхронная генерация и редактирование; см. [Image API](/image-api) | | Видео | Асинхронная генерация, включая управление движением; см. [Video API](/video-api) | | Рабочие процессы | Music Video, Ecommerce Video, Video Analysis; см. [Workflow API](/workflow-api) | | Эффекты | Опубликованные эффекты с одним запуском; см. [Effect API](/effect-api) | | Realtime | Генерация видео в реальном времени через WebRTC; см. [Realtime API](/realtime-api) | `GET /v1/models` возвращает текстовые модели, включённые для аккаунта. Все модели и актуальные тарифы есть на [странице цен](https://beatapi.io/pricing). ## Какие форматы запросов работают? Доступны четыре формата запросов. Поддерживаемые форматы зависят от выбранного семейства моделей: | Формат | Метод API | | ----------------------- | -------------------------------------- | | OpenAI Chat Completions | `POST /v1/chat/completions` | | OpenAI Responses | `POST /v1/responses` | | Anthropic Messages | `POST /v1/messages` | | Совместимый с Gemini | `POST /v1beta/models/{model}:{action}` | Для GPT используйте Chat Completions или Responses, для Claude — Messages. Gemini поддерживает все четыре формата, остальные семейства — Chat Completions, Responses и Messages. Следуйте справочнику выбранного семейства: не следует считать, что любая модель поддерживает любой формат. ## Какие методы намеренно не поддерживаются? `/v1/embeddings`, `/v1/rerank` и `/v1/audio/*` возвращают `404`. Это не недоделанные запланированные функции: они не входят в публичный API. Поэтому инструменту с отдельными моделями чата и embeddings, например [AnythingLLM](/integrations/anythingllm), нужен другой источник векторных представлений. Обычно подойдёт встроенная локальная модель. ## Совместима ли генерация изображений и видео с OpenAI? Нет. Это намеренное решение: API генерации BeatAPI **асинхронный и основан на задачах**: ``` POST /v1/images/tasks -> 201, { "data": { "id": "..." } } GET /v1/tasks/{id} -> poll until succeeded or failed ``` Синхронного `/v1/images/generations` нет. Модель, работающая несколько минут, не может надёжно вернуть результат в одном HTTP-запросе без риска тайм-аута. Поэтому ID задачи возвращается сразу, а готовый результат запрашивается отдельно. За неудачные задачи средства возвращаются; в синхронном вызове такой жизненный цикл неудобно выразить. Жизненный цикл описан в [руководстве разработчика](/development), а [вебхуки](/webhooks) позволяют получать уведомления без постоянного опроса. ## Почему API отвечает иначе, чем готовый чат? Потребительский чат — приложение вокруг модели. API предоставляет саму модель. Приложение может дополнительно предоставлять функции, которые не входят автоматически в вызов модели: * Поиск в интернете и другие инструменты с актуальными данными * Память диалогов между сессиями * Изолированную среду выполнения кода * Подготовленный системный промпт * Поиск по загруженным файлам При работе через API вы сами управляете историей, задаёте системный промпт и при необходимости подключаете вызов инструментов. Это не пропущенные части API, а задачи вашего приложения. ## Поддерживаются ли изображения, инструменты и потоковые ответы? Все текстовые модели поддерживают потоковый ответ через `stream: true`. Работа с изображениями и инструментами зависит от модели. Старого маршрута `deepseek-v4-flash-vision-exp` больше нет в актуальном каталоге BeatAPI; семейства Claude, GPT и Gemini в целом поддерживают мультимодальные данные. Перед проектированием проверьте нужную возможность на странице модели в разделе [Text API](/text-api). ## Как выбрать модель? | Задача | С чего начать | | ---------------------------------- | ---------------------------------------------------------------- | | Программирование с агентом | `claude-fable-5-1`, `gpt-5.6-sol` | | Сложные рассуждения | `claude-opus-5`, `gpt-6-astra`, `deepseek-v4-pro-0813` | | Повседневное общение | `claude-sonnet-5`, `gpt-5.6-terra`, `glm-5.3` | | Большой объём при низкой стоимости | `claude-haiku-4-5-20251001`, `gemini-3.7-flash`, `glm-5.3-flash` | | Длинный контекст | `minimax-m3`, `grok-4.7`, `kimi-k3` | | Работа на китайском языке | `qwen3.8-max`, `glm-5.3`, `hy4-preview` | ID моделей стабильны. Новое поколение получает новый ID; существующий ID не переключается незаметно на другие веса модели. ## Зависят ли цены от времени или длины контекста? Для некоторых моделей — да. Оба условия опубликованы: * **Пиковые часы**: две модели DeepSeek HC (high-cache) удваивают тарифы по будням с 09:00 до 12:00 и с 14:00 до 18:00 по Пекину. Обычные платные модели DeepSeek используют единый тариф круглосуточно. У Hunyuan `hy3` своё ежедневное окно. * **Длина контекста**: у семейств GPT-5.6 и Grok тариф повышается после определённого порога. Точные часы и пороги приведены в примечаниях на [странице цен](https://beatapi.io/pricing). Применённый тариф указан в данных об использовании для каждого ответа. ## Можно ли подключить модели, оплаченные в другом сервисе? В BeatAPI один аккаунт и один баланс. Подключение ключа от другого поставщика не предусмотрено.