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

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

ID μοντέλου API

suno-lyrics

Inputs

text

Files API

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

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

Δυνατότητα

Ήχος

Χρέωση

FIXED

Όριο prompt

200 χαρακτήρες

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

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

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

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

Αυτό το μοντέλο δεν απαιτεί επιπλέον params πέρα από model, prompt και προαιρετικό client_request_id.

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

{
  "model": "suno-lyrics",
  "prompt": "A polished audio concept for a short product story"
}

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

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

{
  "id": "task_suno_lyrics_example",
  "status": "queued",
  "model": "suno-lyrics",
  "reserved_credits": 1,
  "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