ใช้ Suno Sounds ผ่าน Rivya Public API v1 ด้วย model id suno-sounds, input ที่รองรับ, พารามิเตอร์, กฎ Files API, เครดิต และตัวอย่าง response

พร้อมใช้งานผ่าน APItext input พร้อมเสียง

ID โมเดล API

suno-sounds

Input

text

Files API

ไม่จำเป็นสำหรับ request ขั้นต่ำ

เครดิตพื้นฐาน

ความสามารถ

เสียง

Billing

FIXED

ขีดจำกัดพรอมต์

500 อักขระ

contract ของ request

ส่ง model id ที่ระดับบนสุด control เฉพาะโมเดลอยู่ใน params

Key	Type	จำเป็น	ค่าเริ่มต้น	คำอธิบาย
model	string	ใช่	suno-sounds	ใช้ API model id suno-sounds
prompt	string	ใช่	-	สูงสุด 500 อักขระสำหรับโมเดลนี้
params	object	ไม่ใช่	-	object พารามิเตอร์เฉพาะโมเดล ใช้แถวด้านล่างสำหรับ key ที่อนุญาต
client_request_id	string	ไม่ใช่	-	client-side id แบบเลือกได้สำหรับ trace คำขอในระบบของคุณ

พารามิเตอร์โมเดล

Key	Type	จำเป็น	ค่าเริ่มต้น	ช่วง	ตัวเลือก	คำอธิบาย
model	select	ไม่ใช่	V5	-	V5, V5_5	เลือกตระกูลการสร้างของ Suno ที่จะใช้ เวอร์ชันใหม่มักจัดการสไตล์และรายละเอียดได้ดีกว่า แต่อาจต่างกันด้านต้นทุนและพฤติกรรม
soundLoop	select	ไม่ใช่	false	-	false, true	การเล่นแบบลูป
soundTempo	number	ไม่ใช่	-	min 1 / max 300 / step 1	-	ตั้งจังหวะเป็นจำนวนบีตต่อนาที ค่าที่สูงขึ้นมักให้ความรู้สึกเร็วขึ้นและมีประโยชน์มากกว่าสำหรับการออกแบบเสียงที่มีจังหวะ
soundKey	select	ไม่ใช่	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	ตั้งคีย์ทางดนตรี ระบุเฉพาะเมื่อผลลัพธ์ต้องเข้ากับฮาร์โมนีหรือเมโลดี้ที่มีอยู่ มิฉะนั้นการปล่อยให้กว้างมักปลอดภัยกว่า

request ขั้นต่ำ

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

response จากการสร้าง

endpoint create ส่ง public task id กลับมา poll endpoint สถานะจนกว่างานจะสำเร็จหรือล้มเหลว

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

error ทั่วไป

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found