Rivya API

Buduj na wielomodalnej warstwie modeli Rivya

Rivya API daje zespołom produktowym publiczny, oparty na koncie sposób wywoływania modeli Rivya z własnych aplikacji. Zacznij od asynchronicznych zadań obrazu, wideo i audio, dodaj tury Chat API z opcjonalnym strumieniowaniem SSE, gdy model obsługuje chat, i utrzymaj rozliczenia w tym samym portfelu kredytów Rivya.
Przeczytaj dokumentację APIUtwórz klucz API

Kształt szybkiego startu

Warstwa modeli

Dynamiczny katalog

Rozliczenia

Wspólne kredyty

Pierwsza wersja

Zadania + Chat

Dostęp

Klucze API

MetodaPOST
Endpoint/api/v1/generations

Rzeczywiste żądanie wymaga klucza Rivya API i dostępnych kredytów na koncie. Publiczne przykłady używają sekretów zastępczych i nie wywołują modeli anonimowo.

Żądanie
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"
  }'
Odpowiedź
{
  "id": "task_public_id",
  "status": "queued",
  "model": "z-image",
  "reserved_credits": 20,
  "result": null,
  "error": null
}

Co trafia do pierwszej wersji

Publiczna warstwa API spójna z produktem Rivya

API jest zaprojektowane jako powierzchnia produktu Rivya. Używa identyfikatorów modeli Rivya, kredytów Rivya, publicznych stanów zadań oraz dokumentacji połączonej z katalogiem modeli.

API generowania obrazów

Przesyłaj zadania obrazów z promptem i obsługiwanymi parametrami modelu, a potem odpytuj publiczne wyniki.

API generowania wideo

Uruchamiaj asynchroniczne zadania wideo z tymi samymi kontrolami zadań i kredytów, których używa Studio.

API generowania audio

Korzystaj z modeli audio dostępnych przez API w granicach tego samego konta, salda i historii.

Wspólny portfel kredytów

Wywołania API i użycie w Studio korzystają z tego samego salda Rivya, z rezerwacją kredytów i obsługą niepowodzeń.

Ścieżka startowa

Od konta do pierwszego żądania API

01

Utwórz klucz

Zaloguj się, otwórz API Keys w Ustawieniach, utwórz klucz z zakresem uprawnień i od razu zapisz pełny sekret.

02

Wybierz model

Przeczytaj referencję modeli API albo wywołaj /api/v1/models, aby sprawdzić identyfikatory modeli, parametry, możliwości chatu i gotowość danych wejściowych przed wysłaniem żądania.

03

Wyślij, odpytuj albo subskrybuj

Wyślij idempotentne żądanie generowania, odpytuj publiczny endpoint zadania, użyj podpisanych webhooków do callbacków generowania albo wyślij turę Chat API z opcjonalnym strumieniowaniem SSE.

Granica wersji

Jasny zakres bez ukrytych obietnic

Landing page może wspominać przyszłe powierzchnie, ale bieżąca treść produktu nie może sugerować, że niedokończone API są już dostępne.

Chat API

Dostępne

Dostępne dla tur bez strumieniowania i ze strumieniowaniem SSE, z sesjami tworzonymi przez API, kredytami konta i opcjonalnymi załącznikami obrazów z Files API.

Files API

Dostępne

Dostępne do przesyłania obrazów, wideo i audio jako materiałów referencyjnych. Użyj go przed generowaniem, gdy strona modelu wymaga params.referenceMediaItems.

Webhooki użytkownika

Dostępne

Dostępne dla integracji produkcyjnych, które chcą podpisanych callbacków dla udanych lub nieudanych zadań generowania.

Debugger online

Podejrzyj żądanie, a potem uruchom je własnym kluczem API

Debugger zaczyna w trybie mock dla każdego odwiedzającego. Selektor generowania pokazuje modele niebędące chatem, które można testować bez przesyłania plików, a panel Files pozwala zalogowanym użytkownikom testować /api/v1/files z tymczasowym kluczem API. Przykłady chatu są w dokumentacji API.

Stan konta

Sprawdzanie konta

Prefiks aktywnego klucza

Najpierw utwórz klucz

Aktualne kredyty

Zaloguj się, aby sprawdzić

Podgląd mockRzeczywiste Public APIBrak aktywnego klucza API

Tryb mock nigdy nie wywołuje modelu i nigdy nie zużywa kredytów.

Wklej klucz tylko dla tego żądania. Debugger nie przechowuje go po odświeżeniu.

Test przesyłania Files API

Prześlij materiały referencyjne przez POST /api/v1/files, a potem skopiuj zwrócony URL i token czasu trwania do params.referenceMediaItems dla modelu obsługującego wejścia referencyjne.

Mock nigdy nie przesyła plikówLive używa /api/v1/files

Wybrany model określa dozwolone typy MIME, rozmiar i reguły czasu trwania. Rzeczywiste przesyłanie wymaga tymczasowego klucza API i może wywołać rzeczywistą usługę przesyłania.

Utwórz klucz APIPrzeczytaj dokumentację API
Podgląd żądania
{
  "model": "z-image",
  "prompt": "Edytorskie zdjęcie produktu w czystym planie studyjnym",
  "params": {
    "aspect_ratio": "1:1"
  }
}
Odpowiedź
{
  "id": "mock_task_001",
  "status": "queued",
  "model": "z-image",
  "reserved_credits": 1,
  "final_credits": 0,
  "result": null,
  "error": null
}
Odpowiedź Files API
{
  "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
}
Parametry generowania
{
  "params": {
    "referenceMediaItems": [
      {
        "url": "https://media.example/reference.png",
        "kind": "image",
        "name": "reference.png",
        "mimeType": "image/png"
      }
    ]
  }
}

Stan zadania

Szacowane kredyty bazowe

1

Status

queued

Dokumentacja API

Przeczytaj o uwierzytelnianiu, treściach żądań, odpowiedziach, idempotencji, parametrach modeli i kodach błędów.

Otwórz dokumentację

Zarządzanie kluczami API

Twórz, jednorazowo kopiuj, unieważniaj i rotuj klucze API z chronionego obszaru Ustawień.

Zarządzaj kluczami

Debugowanie online

Najpierw użyj przykładów mock; prawdziwe debugowanie wymaga logowania, klucza API i kredytów na koncie.

Podejrzyj przepływ