BeatAPI Image API
Image API
Создайте одну асинхронную задачу генерации изображения, указав постоянный ID модели BeatAPI.
Название модели показывает способ оплаты. -beta — линия с более низкой стоимостью и фиксированной ценой за изображение. Официальные версии оплачиваются по токенам: для GPT Image 2.6 это название без суффикса (например, gpt-image-2.6-flare), для более ранних семейств — -std (например, gpt-image-2-std). Параметр quality принимают только официальные версии GPT Image.
На странице выбранной модели описаны все поля, значения по умолчанию, допустимые значения, правила сочетания параметров, примеры запросов, ответы и ошибки.
Список доступных моделей
GET /v1/media/models
Этот общедоступный метод не требует авторизации.
Внутренняя маршрутизация к поставщикам не входит в публичный контракт.
Общие правила создания задачи
POST /v1/images/tasks
Тело запроса должно соответствовать ровно одной схеме модели. Поле model определяет схему; неизвестные поля отклоняются.
Корректный запрос возвращает 201 Created с data.id, task_kind="image", выбранной model, status="queued", данными об использовании и request_id. Проверяйте GET /v1/tasks/{task_id} каждые 5–10 секунд до succeeded или failed. Готовое изображение доступно в data.output.media[] и data.output.r2_url.
Точный повтор с тем же ключом идемпотентности возвращает уже принятую задачу. Тот же ключ с другим телом запроса даёт 409 idempotency_conflict.
Общие ошибки
Ответ с ошибкой содержит error.code, английское error.message, error.retryable, error.request_id, а при 429 — error.retry_after_seconds. Если уже принятая задача завершилась ошибкой, запрос статуса всё равно возвращает 200: проверьте data.error_code. Все коды и правила повторов описаны в разделе ошибок. Страницы отдельных моделей ниже содержат полные контракты для рабочей среды.

