Страницы API моделей
Интеграция Google Imagen4 Ultra API
Используйте Google Imagen4 Ultra через Rivya Public API v1: ID модели google-imagen4-ultra, поддерживаемые входные данные, параметры, правила Files API, кредиты и примеры ответов.
Доступно через APIГотово для текстового вводаИзображение
ID модели API
google-imagen4-ultra
Входные данные
text
Files API
Не требуется для минимального запроса
Базовые кредиты
12
Возможность
Изображение
Биллинг
FIXED
Лимит промпта
5000 символов
Контракт запроса
Передавайте ID модели на верхнем уровне. Управляющие параметры конкретной модели размещайте в params.
| Ключ | Тип | Обязательно | По умолчанию | Описание |
|---|---|---|---|---|
| model | string | Да | google-imagen4-ultra | Используйте google-imagen4-ultra как ID модели API. |
| 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 задачи. Опрашивайте эндпоинт статуса, пока задача не завершится успехом или ошибкой.