Створіть API-ключ, виберіть модель, надішліть асинхронну задачу генерації та відправте один хід Chat API з необов'язковим потоковим передаванням SSE.

Цей швидкий старт показує найкоротший безпечний шлях від налаштування акаунта до однієї задачі генерації Rivya API, а також першого ходу Chat API.

У документації та прикладах використовуйте ключі-заповнювачі. Ніколи не вставляйте справжній API-ключ у публічний код, скриншоти, тікети або спільні документи.

1. Створіть API-ключ

Відкрийте налаштування API-ключів, створіть ключ, один раз скопіюйте повний секрет і збережіть його в серверному середовищі.

Рекомендовані перші scope:

models:read
generations:create
generations:read
files:create
files:read
credits:read
webhooks:manage
chat:create
chat:read

2. Підтвердьте базовий URL

Використовуйте production API base URL:

https://rivya.ai

URL localhost призначені лише для локальної розробки. У публічних прикладах не слід використовувати локальні secrets.

3. Перегляньте моделі

curl https://rivya.ai/api/v1/models

Використовуйте поле id з відповіді як значення model під час створення генерації.

4. Надішліть генерацію

curl https://rivya.ai/api/v1/generations \
  -H "Authorization: Bearer rvya_sk_..." \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: quickstart-001" \
  -d '{
    "model": "z-image",
    "prompt": "A clean editorial product image on a soft studio background"
  }'

Відповідь повертає публічний task ID. Збережіть його, щоб пізніше опитувати статус.

5. Опитуйте статус

curl https://rivya.ai/api/v1/generations/task_public_id \
  -H "Authorization: Bearer rvya_sk_..."

Значення статусу:

queued
processing
succeeded
failed

6. Перевірте кредити

curl https://rivya.ai/api/v1/credits \
  -H "Authorization: Bearer rvya_sk_..."

Використовуйте це, щоб підтвердити поточний баланс акаунта до або після тестування.

7. Необов'язково: додайте Webhooks

Якщо ваш сервер може приймати підписані HTTPS callback-запити, створіть webhook endpoint:

curl https://rivya.ai/api/v1/webhooks \
  -H "Authorization: Bearer rvya_sk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Production webhook",
    "url": "https://example.com/rivya/webhook",
    "event_types": ["generation.succeeded", "generation.failed"]
  }'

Збережіть одноразовий signing_secret з відповіді й перевіряйте кожну доставку, перш ніж довіряти корисному навантаженню.

8. Необов'язково: надішліть хід Chat

Для chat-моделей викликайте Chat API замість POST /api/v1/generations:

curl https://rivya.ai/api/v1/chat/completions \
  -H "Authorization: Bearer rvya_sk_..." \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: quickstart-chat-001" \
  -d '{
    "model": "gpt-5-2-chat",
    "message": "Write a concise launch plan for a new product image campaign"
  }'

Використовуйте повернений session_id, щоб продовжити сесію, створену через API. Вкладення зображень мають посилатися на значення file_id з Files API.

Необов'язково: використайте TypeScript SDK Beta

Серверні TypeScript-інтеграції можуть використовувати локальну SDK beta:

import { RivyaClient } from "@rivya/sdk";

const rivya = new RivyaClient({
  apiKey: process.env.RIVYA_API_KEY
});

const generation = await rivya.generations.create({
  model: "z-image",
  prompt: "A clean editorial product image on a soft studio background"
});

Перед впровадженням прочитайте Rivya TypeScript SDK. SDK містить серверну підтримку потокового передавання Chat у private beta.

Швидкий старт Rivya API