Страницы API моделей
Интеграция Google Imagen4 Ultra API
Используйте Google Imagen4 Ultra через Rivya Public API v1: model id google-imagen4-ultra, поддерживаемые входные данные, параметры, правила Files API, кредиты и примеры ответов.
Доступно через APIГотово для текстового вводаИзображение
API model id
google-imagen4-ultra
Входные данные
text
Files API
Не требуется для минимального запроса
Базовые кредиты
12
Возможность
Изображение
Биллинг
FIXED
Лимит промпта
5000 символов
Контракт запроса
Передавайте model id на верхнем уровне. Управляющие параметры конкретной модели размещайте в params.
| Ключ | Тип | Обязательно | По умолчанию | Описание |
|---|---|---|---|---|
| model | string | Да | google-imagen4-ultra | Используйте google-imagen4-ultra как API model id. |
| prompt | string | Да | - | Максимум 5000 символов для этой модели. |
| params | object | Нет | - | Объект параметров конкретной модели. Допустимые ключи указаны в таблице ниже. |
| client_request_id | string | Нет | - | Необязательный клиентский id для трассировки запросов в вашей системе. |
Параметры модели
| Ключ | Тип | Обязательно | По умолчанию | Диапазон | Варианты | Описание |
|---|---|---|---|---|---|---|
| aspect_ratio | select | Нет | 1:1 | - | 1:1, 16:9, 9:16, 3:4, 4:3 | Соотношение сторон |
| negative_prompt | text | Нет | - | - | - | Негативный промпт |
| seed | text | Нет | - | - | - | Оставьте поле пустым, чтобы каждый раз получать новый случайный результат. Повторное использование одного и того же целого числа упрощает воспроизведение или точную настройку предыдущего результата. Результат будет ближе только если промпт и другие ключевые настройки тоже остаются похожими, и это не гарантирует совпадение 1:1. |
Минимальный запрос
{
"model": "google-imagen4-ultra",
"prompt": "A clean editorial product image on a soft studio background",
"params": {
"aspect_ratio": "1:1",
"negative_prompt": "Необязательные вещи, которых нужно избежать",
"seed": "Необязательное значение seed"
}
}Ответ создания
Эндпоинт создания возвращает публичный id задачи. Опрашивайте эндпоинт статуса, пока задача не завершится успехом или ошибкой.
{
"id": "task_google_imagen4_ultra_example",
"status": "queued",
"model": "google-imagen4-ultra",
"reserved_credits": 12,
"final_credits": 0,
"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 задачи. Опрашивайте эндпоинт статуса, пока задача не завершится успехом или ошибкой.