Rivya API

Χτίστε πάνω στο πολυτροπικό επίπεδο μοντέλων του Rivya

Το Rivya API δίνει στις ομάδες προϊόντος έναν δημόσιο, account-based τρόπο να καλούν μοντέλα Rivya από τις δικές τους εφαρμογές. Ξεκινήστε με ασύγχρονες εργασίες εικόνας, βίντεο και ήχου, προσθέστε Chat API turns με προαιρετικό SSE streaming όταν το μοντέλο υποστηρίζει chat, και κρατήστε τη χρέωση στο ίδιο Rivya credit wallet.
Διαβάστε τα API docsΔημιουργία API key

Μορφή γρήγορης εκκίνησης

Επίπεδο μοντέλων

Δυναμικός κατάλογος

Χρέωση

Κοινόχρηστα credits

Πρώτη έκδοση

Jobs + Chat

Πρόσβαση

API keys

ΜέθοδοςPOST
Endpoint/api/v1/generations

Το πραγματικό request απαιτεί Rivya API key και διαθέσιμα account credits. Τα δημόσια παραδείγματα χρησιμοποιούν placeholder secrets και δεν καλούν μοντέλα ανώνυμα.

Αίτημα
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": 20,
  "result": null,
  "error": null
}

Τι διατίθεται πρώτα

Ένα δημόσιο επίπεδο API που παραμένει ευθυγραμμισμένο με το προϊόν Rivya

Το API έχει σχεδιαστεί ως επιφάνεια προϊόντος του Rivya. Χρησιμοποιεί Rivya model IDs, Rivya credits, δημόσιες καταστάσεις εργασιών και docs που παραμένουν συνδεδεμένα με τον κατάλογο μοντέλων.

API δημιουργίας εικόνων

Υποβάλετε image jobs με prompt και υποστηριζόμενες παραμέτρους μοντέλου και έπειτα κάντε poll για τα δημόσια αποτελέσματα.

API δημιουργίας βίντεο

Εκτελέστε ασύγχρονα video jobs με τους ίδιους ελέγχους εργασιών και credits που χρησιμοποιεί το Studio.

API δημιουργίας ήχου

Χρησιμοποιήστε audio models προσβάσιμα από API μέσα από το ίδιο όριο λογαριασμού, υπολοίπου και ιστορικού.

Κοινόχρηστο credit wallet

Οι API calls και η χρήση του Studio αντλούν από το ίδιο υπόλοιπο Rivya, με reserved credits και χειρισμό αποτυχίας.

Διαδρομή έναρξης

Από τον λογαριασμό στο πρώτο API request

01

Δημιουργήστε key

Συνδεθείτε, ανοίξτε τα API Keys στις Settings, δημιουργήστε ένα scoped key και αποθηκεύστε αμέσως το πλήρες secret.

02

Επιλέξτε μοντέλο

Διαβάστε το API model reference ή καλέστε το /api/v1/models για να ελέγξετε model IDs, παραμέτρους, chat capabilities και input readiness πριν από την υποβολή.

03

Υποβάλετε, κάντε poll ή εγγραφείτε

Στείλτε ένα idempotent generation request, κάντε poll στο public task endpoint, χρησιμοποιήστε signed webhooks για generation callbacks ή στείλτε ένα Chat API turn με προαιρετικό SSE streaming.

Όριο έκδοσης

Καθαρό scope, χωρίς κρυφές υποσχέσεις

Η landing page μπορεί να αναφέρει μελλοντικές επιφάνειες, αλλά το τρέχον product copy δεν πρέπει να υπονοεί ότι ανολοκλήρωτα APIs είναι ήδη live.

Chat API

Διαθέσιμο

Διαθέσιμο για non-streaming και SSE streaming turns με API-created sessions, account credits και προαιρετικά Files API image attachments.

Files API

Διαθέσιμο

Διαθέσιμο για uploads εικόνων, βίντεο και ήχου αναφοράς. Χρησιμοποιήστε το πριν από τη δημιουργία όταν μια σελίδα μοντέλου ζητά params.referenceMediaItems.

Webhook χρηστών

Διαθέσιμο

Διαθέσιμο για production integrations που θέλουν signed callbacks για επιτυχημένες ή αποτυχημένες generation tasks.

Online εργαλείο αποσφαλμάτωσης

Κάντε preview του request και μετά εκτελέστε το με το δικό σας API key

Ο debugger ξεκινά σε mock mode για κάθε επισκέπτη. Ο generation selector εμφανίζει non-chat models που μπορούν να δοκιμαστούν χωρίς upload αρχείων, ενώ το Files panel επιτρέπει σε συνδεδεμένους χρήστες να δοκιμάσουν το /api/v1/files με προσωρινό API key. Τα Chat examples βρίσκονται στα API docs.

Κατάσταση λογαριασμού

Έλεγχος λογαριασμού

Πρόθεμα active key

Δημιουργήστε πρώτα key

Τρέχοντα credits

Συνδεθείτε για έλεγχο

Δοκιμαστική προεπισκόπησηΖωντανό Public APIΔεν υπάρχει active API key

Το mock mode δεν καλεί ποτέ μοντέλο και δεν καταναλώνει credits.

Επικολλήστε το key μόνο για αυτό το request. Ο debugger δεν το αποθηκεύει μετά από refresh.

Δοκιμή μεταφόρτωσης Files API

Ανεβάστε reference media μέσω POST /api/v1/files και έπειτα αντιγράψτε το returned URL και το duration token στο params.referenceMediaItems για μοντέλο που υποστηρίζει reference inputs.

Το mock δεν ανεβάζει ποτέ αρχείαΤο live χρησιμοποιεί /api/v1/files

Το επιλεγμένο μοντέλο καθορίζει επιτρεπόμενα MIME types, κανόνες μεγέθους και διάρκειας. Τα live uploads απαιτούν το προσωρινό API key σας και μπορεί να καλέσουν την πραγματική υπηρεσία upload.

Δημιουργία API keyΔιαβάστε τα API docs
Προεπισκόπηση request
{
  "model": "z-image",
  "prompt": "Editorial φωτογραφία προϊόντος σε καθαρό 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
}
Απάντηση 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
}
Παράμετροι generation
{
  "params": {
    "referenceMediaItems": [
      {
        "url": "https://media.example/reference.png",
        "kind": "image",
        "name": "reference.png",
        "mimeType": "image/png"
      }
    ]
  }
}

Κατάσταση εργασίας

Εκτιμώμενα base credits

1

Κατάσταση

queued

Τεκμηρίωση API

Διαβάστε για authentication, request bodies, responses, idempotency, model parameters και error codes.

Άνοιγμα docs

Διαχείριση API keys

Δημιουργήστε, αντιγράψτε μία φορά, ανακαλέστε και κάντε rotate API keys από την προστατευμένη περιοχή Settings.

Διαχείριση keys

Online αποσφαλμάτωση

Χρησιμοποιήστε πρώτα mock examples. Το πραγματικό debugging απαιτεί login, API key και account credits.

Προεπισκόπηση ροής