Suno Sounds modelini Rivya Public API v1 üzerinden model id suno-sounds, desteklenen girişler, parametreler, Files API kuralları, krediler ve yanıt örnekleriyle kullanın.

API üzerinden kullanılabilirMetin girişi hazırAudio

API model id

suno-sounds

Girişler

text

Files API

Minimal istek için gerekli değil

Temel krediler

Yetenek

Audio

Faturalandırma

FIXED

Prompt limiti

500 karakter

İstek sözleşmesi

Model id değerini en üst seviyede gönderin. Modele özel kontroller params içine aittir.

Anahtar	Tür	Gerekli	Varsayılan	Açıklama
model	string	Evet	suno-sounds	suno-sounds API model id değerini kullanın.
prompt	string	Evet	-	Bu model için en fazla 500 karakter.
params	object	Hayır	-	Modele özel parametre nesnesi. İzin verilen anahtarlar için aşağıdaki satırları kullanın.
client_request_id	string	Hayır	-	Sisteminizde istekleri izlemek için isteğe bağlı istemci tarafı id.

Model parametreleri

Anahtar	Tür	Gerekli	Varsayılan	Aralık	Seçenekler	Açıklama
model	select	Hayır	V5	-	V5, V5_5	Hangi Suno üretim ailesinin kullanılacağını seçer. Daha yeni sürümler genellikle tarzı ve ayrıntıyı daha iyi işler, ancak maliyet ve davranış açısından farklılık gösterebilir.
soundLoop	select	Hayır	false	-	false, true	Döngü oynatma
soundTempo	number	Hayır	-	min 1 / max 300 / step 1	-	Tempoyu dakika başına vuruş olarak ayarlar. Daha yüksek değerler genellikle daha hızlı hissedilir ve ritmik ses tasarımı için daha kullanışlıdır.
soundKey	select	Hayır	Any	-	Any, Cm, C#m, Dm, D#m, Em, Fm, F#m, Gm, G#m, Am, A#m, Bm, C, C#, D, D#, E, F, F#, G, G#, A, A#, B	Müzikal tonu ayarlar. Yalnızca sonucun mevcut bir armoni veya melodiyle eşleşmesi gerektiğinde belirtin; aksi durumda geniş bırakmak genellikle daha güvenlidir.

Minimal istek

{
  "model": "suno-sounds",
  "prompt": "A polished audio concept for a short product story",
  "params": {
    "model": "V5",
    "soundLoop": "false",
    "soundTempo": 1,
    "soundKey": "Any"
  }
}

Create yanıtı

Create endpointi herkese açık task id döndürür. Görev başarılı veya başarısız olana kadar status endpointini sorgulayın.

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

Yaygın hatalar

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found