01
Opret en nøgle
Log ind, åbn API-nøgler i Indstillinger, opret en nøgle med afgrænset adgang, og gem den fulde secret med det samme.
Rivya AI
Rivya API
Quickstart-form
Modellag
Dynamisk katalog
Fakturering
Fælles credits
Første version
Jobs + Chat
Adgang
API-nøgler
Den rigtige request kræver en Rivya API-nøgle og tilgængelige credits på kontoen. Offentlige eksempler bruger placeholder-secrets og kalder ikke modeller anonymt.
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
Debuggeren starter i mock-tilstand for alle besøgende. Genereringsvælgeren viser ikke-chatmodeller, der kan testes uden filupload, mens Files-panelet lader indloggede brugere teste /api/v1/files med en midlertidig API-nøgle. Chateksempler findes i API-dokumentationen.
Kontotilstand
Tjekker konto
Aktivt nøglepræfiks
Opret først en nøgle
Aktuelle credits
Log ind for at tjekke
Mock-tilstand kalder aldrig en model og bruger aldrig credits.
Indsæt kun nøglen til denne request. Debuggeren gemmer den ikke efter genindlæsning.
Files API-uploadtest
Upload referencemedier via POST /api/v1/files, og kopiér derefter den returnerede URL og duration-token ind i params.referenceMediaItems for en model, der understøtter referenceinput.
Den valgte model styrer tilladte MIME-typer, størrelse og varighedsregler. Live-uploads kræver din midlertidige API-nøgle og kan kalde den rigtige uploadservice.
{
"model": "z-image",
"prompt": "Redaktionelt produktfoto på et rent studiosæt",
"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
}
]
}
}Opgavetilstand
Estimerede basiscredits
1
Status
queued
Startspor
Log ind, åbn API-nøgler i Indstillinger, opret en nøgle med afgrænset adgang, og gem den fulde secret med det samme.
Læs API-modelreferencen, eller kald /api/v1/models for at inspicere model-ID'er, parametre, chatfunktioner og inputklarhed, før du indsender.
Send en idempotent genereringsrequest, poll det offentlige task-endpoint, brug signerede webhooks til genereringscallbacks, eller send en Chat API-turn med valgfri SSE-streaming.
Første levering
API'et er en del af Rivya-produktet. Det bruger Rivya-model-ID'er, Rivya-credits, offentlige opgavetilstande og dokumentation, der er knyttet til modelkataloget.
Indsend billedjobs med prompt og understøttede modelparametre, og poll derefter efter offentlige resultater.
Kør asynkrone videojobs med de samme opgave- og credit-kontroller, som Studio bruger.
Brug API-tilgængelige lydmodeller gennem samme konto-, saldo- og historikgrænse.
API-kald og Studio-brug trækker fra samme Rivya-saldo med reserverede credits og fejlhåndtering.
Versionsgrænse
Denne side adskiller tilgængelige API-funktioner fra fremtidige tilføjelser, så du kan planlægge ud fra det, der er tilgængeligt i dag.
Tilgængelig til ikke-streaming og SSE-streaming-turns med API-oprettede sessioner, kontocredits og valgfrie Files API-billedvedhæftninger.
Tilgængelig til uploads af referencebilleder, -videoer og -lyd. Brug den før generering, når en modelside beder om params.referenceMediaItems.
Tilgængelig til produktionsintegrationer, der ønsker signerede callbacks for vellykkede eller fejlede genereringsopgaver.
Læs om autentificering, request bodies, svar, idempotens, modelparametre og fejlkoder.
Åbn dokumentationOpret en API-nøgle, og kopiér den én gang. Udskift den ved at oprette en ny nøgle og tilbagekalde den gamle i det beskyttede område Indstillinger.
Administrér nøglerBrug mock-eksempler først; live-debugging kræver login, en API-nøgle og kontocredits.
Forhåndsvis flow