Rivya API

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

Το Rivya API δίνει στις ομάδες προϊόντος έναν δημόσιο τρόπο, βασισμένο σε λογαριασμό, να καλούν μοντέλα Rivya από τις εφαρμογές τους. Ξεκινήστε με ασύγχρονες εργασίες εικόνας, βίντεο και ήχου, προσθέστε γύρους Chat API με προαιρετική ροή SSE όταν το μοντέλο υποστηρίζει συνομιλία και κρατήστε τη χρέωση στο ίδιο πορτοφόλι credits Rivya.
Διαβάστε την τεκμηρίωση APIΔημιουργία κλειδιού API

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

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

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

Χρέωση

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

Πρώτη έκδοση

Εργασίες + Chat

Πρόσβαση

Κλειδιά API

ΜέθοδοςPOST
Τελικό σημείο/api/v1/generations

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

Αίτημα
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
}

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

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

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

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

Υποβάλετε εργασίες εικόνας με προτροπή και υποστηριζόμενες παραμέτρους μοντέλου και έπειτα ελέγξτε την κατάσταση για τα δημόσια αποτελέσματα.

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

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

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

Χρησιμοποιήστε μοντέλα ήχου μέσω API με τα ίδια όρια λογαριασμού, υπόλοιπο και ιστορικό.

Κοινόχρηστο πορτοφόλι credits

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

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

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

01

Δημιουργήστε κλειδί

Συνδεθείτε, ανοίξτε τα κλειδιά API στις Ρυθμίσεις, δημιουργήστε ένα κλειδί με συγκεκριμένα δικαιώματα και αποθηκεύστε αμέσως το πλήρες μυστικό.

02

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

Διαβάστε την αναφορά μοντέλων API ή καλέστε το /api/v1/models για να ελέγξετε αναγνωριστικά μοντέλων, παραμέτρους, δυνατότητες συνομιλίας και ετοιμότητα εισόδων πριν από την υποβολή.

03

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

Στείλτε ένα ιδιοδύναμο αίτημα δημιουργίας, ελέγχετε περιοδικά το δημόσιο τελικό σημείο εργασίας, χρησιμοποιήστε υπογεγραμμένα webhooks για ενημερώσεις δημιουργίας ή στείλτε έναν γύρο Chat API με προαιρετική ροή SSE.

Όριο έκδοσης

Σαφές εύρος, χωρίς κρυφές υποσχέσεις

Αυτή η σελίδα ξεχωρίζει τις διαθέσιμες δυνατότητες API από τις μελλοντικές προσθήκες, ώστε να σχεδιάζετε με βάση όσα λειτουργούν σήμερα.

Chat API

Διαθέσιμο

Διαθέσιμο για αποκρίσεις χωρίς ροή και με ροή SSE, με συνεδρίες που δημιουργούνται μέσω API, credits λογαριασμού και προαιρετικές συνημμένες εικόνες από το Files API.

Files API

Διαθέσιμο

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

Webhook χρηστών

Διαθέσιμο

Διαθέσιμο για ενσωματώσεις παραγωγής που χρειάζονται υπογεγραμμένες ειδοποιήσεις επανάκλησης για επιτυχημένες ή αποτυχημένες εργασίες δημιουργίας.

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

Δείτε την προεπισκόπηση του αιτήματος και έπειτα εκτελέστε το με το δικό σας κλειδί API

Το εργαλείο εντοπισμού σφαλμάτων ξεκινά σε λειτουργία προσομοίωσης για κάθε επισκέπτη. Ο επιλογέας δημιουργίας εμφανίζει μοντέλα χωρίς συνομιλία που δοκιμάζονται χωρίς μεταφόρτωση αρχείων, ενώ ο πίνακας Files επιτρέπει σε συνδεδεμένους χρήστες να δοκιμάσουν το /api/v1/files με προσωρινό κλειδί API. Τα παραδείγματα Chat βρίσκονται στην τεκμηρίωση API.

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

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

Πρόθεμα active key

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

Τρέχοντα credits

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

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

Η λειτουργία προσομοίωσης δεν καλεί ποτέ μοντέλο και δεν καταναλώνει credits.

Επικολλήστε το κλειδί μόνο για αυτό το αίτημα. Το εργαλείο εντοπισμού σφαλμάτων δεν το αποθηκεύει μετά την ανανέωση της σελίδας.

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

Ανεβάστε πολυμέσα αναφοράς μέσω POST /api/v1/files και έπειτα αντιγράψτε το URL που επιστράφηκε και το token διάρκειας στο params.referenceMediaItems για μοντέλο που υποστηρίζει εισόδους αναφοράς.

Η προσομοίωση δεν ανεβάζει ποτέ αρχείαΗ πραγματική λειτουργία χρησιμοποιεί το /api/v1/files

Το επιλεγμένο μοντέλο καθορίζει τους επιτρεπόμενους τύπους MIME και τους κανόνες μεγέθους και διάρκειας. Οι πραγματικές μεταφορτώσεις απαιτούν το προσωρινό κλειδί API και μπορεί να καλέσουν την πραγματική υπηρεσία μεταφόρτωσης.

Δημιουργία API keyΔιαβάστε τα API docs
Προεπισκόπηση αιτήματος
{
  "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

Διαβάστε για τον έλεγχο ταυτότητας, τα σώματα αιτημάτων, τις αποκρίσεις, την ιδιοδυναμία, τις παραμέτρους μοντέλων και τους κωδικούς σφαλμάτων.

Άνοιγμα docs

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

Δημιουργήστε, αντιγράψτε μία φορά, ανακαλέστε και ανανεώστε κλειδιά API από την προστατευμένη περιοχή Ρυθμίσεων.

Διαχείριση keys

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

Χρησιμοποιήστε πρώτα παραδείγματα προσομοίωσης. Ο πραγματικός εντοπισμός σφαλμάτων απαιτεί σύνδεση, κλειδί API και credits λογαριασμού.

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