Модели и возможности

Что предоставляет BeatAPI?

GET /v1/models возвращает текстовые модели, включённые для аккаунта. Все модели и актуальные тарифы есть на странице цен.

Какие форматы запросов работают?

Доступны четыре формата запросов. Поддерживаемые форматы зависят от выбранного семейства моделей:

Для GPT используйте Chat Completions или Responses, для Claude — Messages. Gemini поддерживает все четыре формата, остальные семейства — Chat Completions, Responses и Messages. Следуйте справочнику выбранного семейства: не следует считать, что любая модель поддерживает любой формат.

Какие методы намеренно не поддерживаются?

/v1/embeddings, /v1/rerank и /v1/audio/* возвращают 404. Это не недоделанные запланированные функции: они не входят в публичный API.

Поэтому инструменту с отдельными моделями чата и embeddings, например 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 задачи возвращается сразу, а готовый результат запрашивается отдельно. За неудачные задачи средства возвращаются; в синхронном вызове такой жизненный цикл неудобно выразить.

Жизненный цикл описан в руководстве разработчика, а вебхуки позволяют получать уведомления без постоянного опроса.

Почему API отвечает иначе, чем готовый чат?

Потребительский чат — приложение вокруг модели. API предоставляет саму модель.

Приложение может дополнительно предоставлять функции, которые не входят автоматически в вызов модели:

• Поиск в интернете и другие инструменты с актуальными данными
• Память диалогов между сессиями
• Изолированную среду выполнения кода
• Подготовленный системный промпт
• Поиск по загруженным файлам

При работе через API вы сами управляете историей, задаёте системный промпт и при необходимости подключаете вызов инструментов. Это не пропущенные части API, а задачи вашего приложения.

Поддерживаются ли изображения, инструменты и потоковые ответы?

Все текстовые модели поддерживают потоковый ответ через stream: true.

Работа с изображениями и инструментами зависит от модели. Старого маршрута deepseek-v4-flash-vision-exp больше нет в актуальном каталоге BeatAPI; семейства Claude, GPT и Gemini в целом поддерживают мультимодальные данные. Перед проектированием проверьте нужную возможность на странице модели в разделе Text API.

Как выбрать модель?

ID моделей стабильны. Новое поколение получает новый ID; существующий ID не переключается незаметно на другие веса модели.

Зависят ли цены от времени или длины контекста?

Для некоторых моделей — да. Оба условия опубликованы:

• Пиковые часы: две модели DeepSeek HC (high-cache) удваивают тарифы по будням с 09:00 до 12:00 и с 14:00 до 18:00 по Пекину. Обычные платные модели DeepSeek используют единый тариф круглосуточно. У Hunyuan hy3 своё ежедневное окно.
• Длина контекста: у семейств GPT-5.6 и Grok тариф повышается после определённого порога.

Точные часы и пороги приведены в примечаниях на странице цен. Применённый тариф указан в данных об использовании для каждого ответа.

Можно ли подключить модели, оплаченные в другом сервисе?

В BeatAPI один аккаунт и один баланс. Подключение ключа от другого поставщика не предусмотрено.