01
Key erstellen
Melde dich an, öffne API Keys in den Einstellungen, erstelle einen Key mit Scopes und speichere das vollständige Secret sofort.
Rivya AI
Rivya API
Quickstart-Form
Modellschicht
Dynamischer Katalog
Abrechnung
Gemeinsame Credits
Erste Version
Jobs + Chat
Zugriff
API Keys
Die echte Anfrage benötigt einen Rivya API Key und verfügbare Kontocredits. Öffentliche Beispiele nutzen Platzhalter-Secrets und rufen Modelle nicht anonym auf.
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
}Online-Debugger
Der Debugger startet für jeden Besucher im Mock-Modus. Der Generierungsselektor listet Nicht-Chat-Modelle, die ohne Datei-Upload getestet werden können, während das Files-Panel angemeldeten Nutzern erlaubt, /api/v1/files mit einem temporären API Key zu testen. Chat-Beispiele stehen in der API-Dokumentation.
Kontostatus
Konto wird geprüft
Aktives Key-Präfix
Erstelle zuerst einen Key
Aktuelle Credits
Zum Prüfen anmelden
Der Mock-Modus ruft nie ein Modell auf und verbraucht keine Credits.
Füge den Key nur für diese Anfrage ein. Der Debugger speichert ihn nach einer Aktualisierung nicht.
Files API Upload-Test
Lade Referenzmedien über POST /api/v1/files hoch und kopiere dann die zurückgegebene URL sowie das duration token in params.referenceMediaItems für ein Modell, das Referenzeingaben unterstützt.
Das ausgewählte Modell steuert erlaubte MIME-Typen, Grösse und Dauerregeln. Live-Uploads benötigen deinen temporären API Key und können den echten Upload-Service aufrufen.
{
"model": "z-image",
"prompt": "Editoriales Produktfoto in einem aufgeräumten Studio-Set",
"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
}
]
}
}Aufgabenstatus
Geschätzte Basiscredits
1
Status
queued
Startpfad
Melde dich an, öffne API Keys in den Einstellungen, erstelle einen Key mit Scopes und speichere das vollständige Secret sofort.
Lies die API-Modellreferenz oder rufe /api/v1/models auf, um Modell-IDs, Parameter, Chat-Fähigkeiten und Eingabebereitschaft vor dem Einreichen zu prüfen.
Sende eine idempotente Generierungsanfrage, frage den öffentlichen Aufgabenendpunkt ab, nutze signierte Webhooks für Generierungs-Callbacks oder sende einen Chat API-Turn mit optionalem SSE-Streaming.
Was zuerst ausgeliefert wird
Die API ist Teil des Rivya-Produkts. Sie nutzt Rivya-Modell-IDs, Rivya-Credits, öffentliche Aufgabenstatus und eine mit dem Modellkatalog verknüpfte Dokumentation.
Reiche Bild-Jobs mit Prompt und unterstützten Modellparametern ein und frage anschliessend öffentliche Ergebnisse ab.
Führe asynchrone Video-Jobs mit denselben Aufgaben- und Credit-Kontrollen aus, die Studio verwendet.
Nutze per API zugängliche Audiomodelle über dasselbe Konto, Guthaben und dieselbe Verlaufsgrenze.
API-Aufrufe und Studio-Nutzung ziehen aus demselben Rivya-Guthaben, mit reservierten Credits und Fehlerbehandlung.
Versionsgrenze
Diese Seite trennt verfügbare API-Funktionen von späteren Ergänzungen, damit du mit dem planen kannst, was heute bereits verfügbar ist.
Verfügbar für nicht-streamende und SSE-streamende Turns mit API-erstellten Sessions, Kontocredits und optionalen Files API-Bildanhängen.
Verfügbar für Referenzbild-, Video- und Audio-Uploads. Nutze sie vor der Generierung, wenn eine Modellseite params.referenceMediaItems verlangt.
Verfügbar für Produktionsintegrationen, die signierte Callbacks für erfolgreiche oder fehlgeschlagene Generierungsaufgaben wünschen.
Lies Authentifizierung, Request Bodies, Antworten, Idempotenz, Modellparameter und Fehlercodes.
Docs öffnenErstelle, kopiere einmalig, widerrufe und rotiere API Keys im geschützten Einstellungsbereich.
Keys verwaltenNutze zuerst Mock-Beispiele; echtes Debugging benötigt Login, einen API Key und Kontocredits.
Ablauf prüfen