Τεκμηρίωση Rivya AI
Σελίδες API μοντέλων

Ενσωμάτωση API για Suno Music

Χρησιμοποιήστε το Suno Music μέσω του Rivya Public API v1 με αναγνωριστικό μοντέλου suno-music, υποστηριζόμενες εισόδους, παραμέτρους, κανόνες Files API, credits και παραδείγματα απόκρισης.

Διαθέσιμο μέσω APIΕίσοδος κειμένου έτοιμηΉχος
ID μοντέλου API

suno-music

Είσοδοι

text

Files API

Δεν απαιτείται για το ελάχιστο αίτημα

Βασικές πιστώσεις

12

Δυνατότητα

Ήχος

Χρέωση

FIXED

Όριο prompt

500 χαρακτήρες

Σύμβαση αιτήματος

Στείλτε το αναγνωριστικό μοντέλου στο ανώτερο επίπεδο. Οι έλεγχοι που είναι ειδικοί για το μοντέλο ανήκουν στο params.

ΚλειδίΤύποςΥποχρεωτικόΠροεπιλογήΠεριγραφή
modelstringΝαιsuno-musicΧρησιμοποιήστε το suno-music ως αναγνωριστικό μοντέλου API.
promptstringΝαι-Μέγιστο 500 χαρακτήρες για αυτό το μοντέλο.
paramsobjectΌχι-Αντικείμενο παραμέτρων ειδικό για το μοντέλο. Χρησιμοποιήστε τις παρακάτω γραμμές για τα επιτρεπόμενα κλειδιά.
client_request_idstringΌχι-Προαιρετικό client-side id για ιχνηλάτηση αιτημάτων στο δικό σας σύστημα.

Παράμετροι μοντέλου

ΚλειδίΤύποςΥποχρεωτικόΠροεπιλογήΕύροςΕπιλογέςΠεριγραφή
modelselectΌχιV4_5-V4, V4_5, V4_5PLUS, V4_5ALL, V5, V5_5Επιλέγει ποια οικογένεια δημιουργίας Suno θα χρησιμοποιηθεί. Οι νεότερες εκδόσεις συχνά χειρίζονται καλύτερα το στιλ και τη λεπτομέρεια, αλλά μπορεί να διαφέρουν σε κόστος και συμπεριφορά.
instrumentalselectΌχιfalse-false, trueInstrumental

Ελάχιστο αίτημα

{
  "model": "suno-music",
  "prompt": "A polished audio concept for a short product story",
  "params": {
    "model": "V4_5",
    "instrumental": "false"
  }
}

Απόκριση δημιουργίας

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

{
  "id": "task_suno_music_example",
  "status": "queued",
  "model": "suno-music",
  "reserved_credits": 12,
  "final_credits": 0,
  "created_at": "2026-05-11T00:00:00.000Z",
  "updated_at": "2026-05-11T00:00:00.000Z",
  "result": null,
  "error": null
}

Συνηθισμένα σφάλματα

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

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