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

Διαθέσιμο μέσω APIText input έτοιμοΉχος

ID μοντέλου API

suno-music

Inputs

text

Files API

Δεν απαιτείται για το minimal request

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

Δυνατότητα

Ήχος

Χρέωση

FIXED

Όριο prompt

500 χαρακτήρες

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

Στείλτε το model id στο top level. Τα model-specific controls ανήκουν στο params.

Key	Τύπος	Υποχρεωτικό	Προεπιλογή	Περιγραφή
model	string	Ναι	suno-music	Χρησιμοποιήστε το suno-music ως API model id.
prompt	string	Ναι	-	Μέγιστο 500 χαρακτήρες για αυτό το μοντέλο.
params	object	Όχι	-	Model-specific parameter object. Χρησιμοποιήστε τις παρακάτω γραμμές για τα επιτρεπόμενα keys.
client_request_id	string	Όχι	-	Προαιρετικό client-side id για tracing requests στο δικό σας σύστημα.

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

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

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

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

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

Το create endpoint επιστρέφει public task id. Κάντε poll στο status endpoint μέχρι το task να succeed ή fail.

{
  "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