↓
Документация Rivya AI
Страницы API моделей

Интеграция 4o Image API

Используйте 4o Image через Rivya Public API v1: ID модели 4o-image, поддерживаемые входные данные, параметры, правила Files API, кредиты и примеры ответов.

Доступно через APIГотово для текстового вводаИзображение
ID модели API

4o-image

Входные данные

text

Files API

Не требуется для минимального запроса

Базовые кредиты

Ставка в кредитах: 3 / запрос Итоговая стоимость задачи округляется вверх до целых кредитов.

Возможность

Изображение

Биллинг

FIXED

Лимит промпта

Документированный лимит промпта отсутствует

Контракт запроса

Передавайте ID модели на верхнем уровне. Управляющие параметры конкретной модели размещайте в params.

КлючТипОбязательноПо умолчаниюОписание
modelstringДа4o-imageИспользуйте 4o-image как ID модели API.
promptstringДа-Текст промпта для моделей, поддерживающих текстовый ввод.
paramsobjectНет-Объект параметров конкретной модели. Допустимые ключи указаны в таблице ниже.
client_request_idstringНет-Необязательный клиентский id для трассировки запросов в вашей системе.

Параметры модели

КлючТипОбязательноПо умолчаниюДиапазонВариантыОписание
sizeselectНет1:1-1:1, 3:2, 2:3Соотношение сторон

Минимальный запрос

{
  "model": "4o-image",
  "prompt": "Флакон продукта на светло-сером фоне с мягким освещением слева.",
  "params": {
    "size": "1:1"
  }
}

Ответ создания

Эндпоинт создания возвращает публичный id задачи. Опрашивайте эндпоинт статуса, пока задача не завершится успехом или ошибкой.

{
  "id": "task_4o_image_example",
  "status": "queued",
  "model": "4o-image",
  "reserved_credits": 3,
  "final_credits": 0,
  "settlement_status": "RESERVED",
  "created_at": "2026-05-11T00:00:00.000Z",
  "updated_at": "2026-05-11T00:00:00.000Z",
  "result": null,
  "error": null
}

Распространенные ошибки

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Эндпоинт создания возвращает публичный id задачи. Опрашивайте эндпоинт статуса, пока задача не завершится успехом или ошибкой.