Rivya API

Construiește pe stratul multimodal de modele Rivya

Rivya API oferă echipelor de produs o cale publică, bazată pe cont, pentru a apela modelele Rivya din propriile aplicații. Începe cu sarcini asincrone de imagine, video și audio, adaugă interacțiuni Chat API cu streaming SSE opțional când modelul suportă chat și păstrează facturarea în același portofel de credite Rivya.
Citește documentația APICreează o cheie API

Format de pornire rapidă

Strat de modele

Catalog dinamic

Facturare

Credite partajate

Prima versiune

Joburi + Chat

Acces

Chei API

MetodăPOST
Endpoint/api/v1/generations

Cererea reală necesită o cheie API Rivya și credite disponibile în cont. Exemplele publice folosesc secrete placeholder și nu apelează modele în mod anonim.

Cerere
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"
  }'
Răspuns
{
  "id": "task_public_id",
  "status": "queued",
  "model": "z-image",
  "reserved_credits": 1,
  "result": null,
  "error": null
}

Ce este livrat prima dată

Un strat API public care rămâne aliniat cu produsul Rivya

API-ul face parte din produsul Rivya. Folosește ID-uri de modele Rivya, credite Rivya, stări publice ale sarcinilor și documentație conectată la catalogul de modele.

API generare imagini

Trimite sarcini de imagine cu prompt și parametri suportați de model, apoi interoghează rezultatele publice.

API generare video

Rulează sarcini video asincrone cu aceleași controale de sarcină și credite folosite de Studio.

API generare audio

Folosește modele audio accesibile prin API în aceeași limită de cont, sold și istoric.

Portofel de credite partajat

Apelurile API și utilizarea Studio trag din același sold Rivya, cu credite rezervate și gestionarea eșecurilor.

Traseu de început

De la cont la prima cerere API

01

Creează o cheie

Autentifică-te, deschide API Keys în Setări, creează o cheie cu domeniu de acces și stochează imediat secretul complet.

02

Alege un model

Citește referința de modele API sau apelează /api/v1/models pentru a inspecta ID-urile modelelor, parametrii, capabilitățile chat și pregătirea intrărilor înainte de trimitere.

03

Trimite, interoghează sau abonează-te

Trimite o cerere de generare idempotentă, interoghează endpointul public de sarcină, folosește webhookuri semnate pentru callbackuri de generare sau trimite o interacțiune Chat API cu streaming SSE opțional.

Limită versiune

Domeniu clar, fără promisiuni ascunse

Această pagină separă funcțiile API disponibile de completările viitoare, ca să îți poți face planul pe baza a ceea ce este activ astăzi.

Chat API

Disponibil

Disponibil pentru interacțiuni non-streaming și streaming SSE cu sesiuni create prin API, credite de cont și atașamente opționale de imagine prin Files API.

Files API

Disponibil

Disponibil pentru încărcări de imagini, video și audio de referință. Folosește-l înainte de generare când o pagină de model cere params.referenceMediaItems.

Webhookuri utilizator

Disponibil

Disponibile pentru integrări de producție care vor callbackuri semnate pentru sarcini de generare reușite sau eșuate.

Depanator online

Previzualizează cererea, apoi ruleaz-o cu propria cheie API

Depanatorul începe în mod de simulare pentru fiecare vizitator. Selectorul de generare listează modele non-chat care pot fi testate fără încărcare de fișiere, iar panoul Files permite utilizatorilor autentificați să testeze /api/v1/files cu o cheie API temporară. Exemplele Chat sunt în documentația API.

Stare cont

Se verifică contul

Prefix cheie activă

Creează mai întâi o cheie

Credite curente

Autentifică-te pentru verificare

Previzualizare simulatăPublic API realNicio cheie API activă

Modul simulat nu apelează niciodată un model și nu consumă credite.

Lipește cheia doar pentru această cerere. Depanatorul nu o stochează după reîmprospătare.

Test de încărcare Files API

Încarcă media de referință prin POST /api/v1/files, apoi copiază URL-ul returnat și duration token în params.referenceMediaItems pentru un model care acceptă intrări de referință.

Simularea nu încarcă niciodată fișiereModul real folosește /api/v1/files

Modelul selectat controlează tipurile MIME permise, dimensiunea și regulile de durată. Încărcările reale necesită cheia API temporară și pot apela serviciul real de încărcare.

Creează cheia APICitește documentația API
Previzualizare cerere
{
  "model": "z-image",
  "prompt": "Fotografie editorială de produs într-un decor de studio curat",
  "params": {
    "aspect_ratio": "1:1"
  }
}
Răspuns
{
  "id": "mock_task_001",
  "status": "queued",
  "model": "z-image",
  "reserved_credits": 1,
  "final_credits": 0,
  "result": null,
  "error": null
}
Răspuns 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
}
Parametri generare
{
  "params": {
    "referenceMediaItems": [
      {
        "url": "https://media.example/reference.png",
        "kind": "image",
        "name": "reference.png",
        "mimeType": "image/png"
      }
    ]
  }
}

Stare sarcină

Credite de bază estimate

1

Stare

queued

Documentație API

Citește despre autentificare, corpurile cererilor, răspunsuri, idempotență, parametri de model și coduri de eroare.

Deschide documentația

Gestionarea cheilor API

Creează, copiază o singură dată, revocă și rotește chei API din zona protejată Setări.

Gestionează cheile

Depanare online

Folosește mai întâi exemple simulate; depanarea reală necesită autentificare, o cheie API și credite în cont.

Previzualizează fluxul