01
Создайте ключ
Войдите, откройте API-ключи в настройках, создайте ключ с нужной областью доступа и сразу сохраните полный секрет.
Rivya AI
Rivya API
Форма быстрого старта
Слой моделей
Динамический каталог
Биллинг
Общие кредиты
Первая версия
Задания + чат
Доступ
API-ключи
Для реального запроса нужен Rivya API-ключ и доступные кредиты аккаунта. Публичные примеры используют секреты-заглушки и не вызывают модели анонимно.
curl https://rivya.ai/api/v1/generations \
-H "Authorization: Bearer rvya_sk_..." \
-H "Content-Type: application/json" \
-H "Idempotency-Key: demo-job-001" \
-d '{
"model": "z-image",
"prompt": "Editorial product photo on a clean studio set"
}'{
"id": "task_public_id",
"status": "queued",
"model": "z-image",
"reserved_credits": 1,
"result": null,
"error": null
}Онлайн-отладчик
Отладчик для каждого посетителя стартует в тестовом режиме. Селектор генерации показывает нечатовые модели, которые можно тестировать без загрузки файлов, а панель Files позволяет пользователям после входа тестировать /api/v1/files с временным API-ключом. Примеры Chat находятся в документации API.
Состояние аккаунта
Проверяем аккаунт
Префикс активного ключа
Сначала создайте ключ
Текущие кредиты
Войдите, чтобы проверить
Тестовый режим никогда не вызывает модель и не расходует кредиты.
Вставляйте ключ только для этого запроса. Отладчик не хранит его после обновления страницы.
Тест загрузки через Files API
Загрузите референсные медиа через POST /api/v1/files, затем скопируйте возвращенный URL и токен длительности в params.referenceMediaItems для модели, поддерживающей референсные входные данные.
Выбранная модель определяет разрешенные MIME-типы, размер и правила длительности. Боевые загрузки требуют временный API-ключ и могут вызвать реальный сервис загрузки.
{
"model": "z-image",
"prompt": "Редакционное фото продукта на чистой студийной площадке",
"params": {
"aspect_ratio": "1:1"
}
}{
"id": "mock_task_001",
"status": "queued",
"model": "z-image",
"reserved_credits": 1,
"final_credits": 0,
"result": null,
"error": null
}{
"id": "file_mock_001",
"object": "file",
"kind": "image",
"file_name": "reference.png",
"mime_type": "image/png",
"size_bytes": 245760,
"url": "https://media.example/reference.png",
"duration_seconds": null,
"duration_token": null,
"created_at": "2026-05-11T00:00:00.000Z",
"expires_at": null
}{
"params": {
"referenceMediaItems": [
{
"url": "https://media.example/reference.png",
"kind": "image",
"name": "reference.png",
"mimeType": "image/png",
"sizeBytes": 245760
}
]
}
}Состояние задачи
Оценка базовых кредитов
1
Статус
queued
Стартовый путь
Войдите, откройте API-ключи в настройках, создайте ключ с нужной областью доступа и сразу сохраните полный секрет.
Читайте справочник API-моделей или вызовите /api/v1/models, чтобы проверить ID моделей, параметры, возможности чата и готовность входных данных перед отправкой.
Отправьте идемпотентный запрос генерации, опрашивайте публичный эндпоинт задачи, используйте подписанные вебхуки для обратных вызовов генерации или отправьте обращение Chat API с опциональным SSE-стримингом.
Что выходит первым
API является частью продукта Rivya. Он использует ID моделей и кредиты Rivya, публичные состояния задач и документацию, связанную с каталогом моделей.
Отправляйте задания генерации изображений с промптом и поддерживаемыми параметрами модели, затем опрашивайте публичные результаты.
Запускайте асинхронные задания генерации видео с теми же механизмами управления задачами и кредитами, что использует Studio.
Используйте аудиомодели, доступные через API, в рамках того же аккаунта, баланса и истории.
Вызовы API и использование Studio расходуют один баланс Rivya, с резервированием кредитов и обработкой ошибок.
Граница версии
На этой странице доступные возможности API отделены от будущих дополнений, чтобы вы могли планировать интеграцию с учетом того, что работает уже сейчас.
Доступен для нестриминговых и SSE-стриминговых обращений с сессиями, созданными через API, кредитами аккаунта и опциональными изображениями-вложениями Files API.
Доступен для загрузки референсных изображений, видео и аудио. Используйте его перед генерацией, когда страница модели требует params.referenceMediaItems.
Доступны для производственных интеграций, которым нужны подписанные колбэки для успешных или неудачных задач генерации.
Читайте про аутентификацию, тела запросов, ответы, идемпотентность, параметры моделей и коды ошибок.
Открыть документациюСоздайте API-ключ и скопируйте его один раз. Для замены создайте новый ключ и отзовите старый в защищённом разделе настроек.
Управлять ключамиСначала используйте тестовые примеры; реальная отладка требует входа, API-ключа и кредитов аккаунта.
Предпросмотр потока