Opret en API-nøgle, vælg en model, indsend et asynkront genereringsjob, og send en Chat API-turn med valgfri SSE-streaming.

Denne quickstart viser den korteste sikre vej fra kontoopsætning til ét Rivya API-genereringsjob plus den første Chat API-turn.

Brug placeholder-nøgler i docs og eksempler. Indsæt aldrig en rigtig API-nøgle i offentlig kode, screenshots, tickets eller delte dokumenter.

1. Opret en API-nøgle

Åbn API Keys-indstillinger, opret en nøgle, kopiér den fulde secret én gang, og gem den i dit server-side miljø.

Anbefalede første scopes:

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

2. Bekræft din base-URL

Brug production API base URL:

https://rivya.ai

Localhost-URL'er er kun til lokal udvikling. Offentlige eksempler bør ikke bruge lokale secrets.

3. List modeller

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

Brug feltet id fra svaret som model-værdi, når du opretter en generation.

4. Indsend en generation

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"
  }'

Svaret returnerer et offentligt task-ID. Gem det, så du kan polle status senere.

5. Poll status

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

Statusværdierne er:

queued
processing
succeeded
failed

6. Tjek credits

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

Brug dette til at bekræfte den aktuelle kontosaldo før eller efter test.

7. Valgfrit: tilføj webhooks

Hvis din server kan modtage signerede HTTPS-callbacks, kan du oprette et 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"]
  }'

Gem den engangsviste signing_secret fra svaret, og verificer hver delivery, før du stoler på payloaden.

8. Valgfrit: send en chat-turn

For chatmodeller skal du kalde Chat API i stedet for 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"
  }'

Brug det returnerede session_id til at fortsætte den API-oprettede session. Billedvedhæftninger skal referere til Files API file_id-værdier.

Valgfrit: brug TypeScript SDK Beta

Server-side TypeScript-integrationer kan bruge den lokale 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"
});

Læs Rivya TypeScript SDK, før du tager den i brug. SDK'en inkluderer server-side Chat streaming-support i den private beta.

Rivya API quickstart