Dùng Suno Sounds qua Rivya Public API v1 với ID mô hình suno-sounds, đầu vào được hỗ trợ, tham số, quy tắc Files API, tín dụng và ví dụ phản hồi.

Khả dụng qua APIĐầu vào văn bản sẵn sàngÂm thanh

ID mô hình API

suno-sounds

Đầu vào

text

Files API

Không bắt buộc cho yêu cầu tối thiểu

Tín dụng cơ bản

Năng lực

Âm thanh

Thanh toán

FIXED

Giới hạn prompt

500 ký tự

Quy ước yêu cầu

Gửi ID mô hình ở cấp trên cùng. Điều khiển riêng của mô hình nằm trong params.

Key	Loại	Bắt buộc	Mặc định	Mô tả
model	string	Có	suno-sounds	Dùng suno-sounds làm ID mô hình API.
prompt	string	Có	-	Tối đa 500 ký tự cho mô hình này.
params	object	Không	-	Đối tượng tham số riêng của mô hình. Dùng các dòng bên dưới để xem key được phép.
client_request_id	string	Không	-	ID phía client không bắt buộc để theo dõi yêu cầu trong hệ thống của bạn.

Tham số mô hình

Key	Loại	Bắt buộc	Mặc định	Phạm vi	Tùy chọn	Mô tả
model	select	Không	V5	-	V5, V5_5	Chọn họ tạo Suno sẽ dùng. Phiên bản mới hơn thường xử lý phong cách và chi tiết tốt hơn, nhưng có thể khác về chi phí và hành vi.
soundLoop	select	Không	false	-	false, true	Phát loop
soundTempo	number	Không	-	min 1 / max 300 / step 1	-	Đặt tempo theo nhịp mỗi phút. Giá trị cao hơn thường tạo cảm giác nhanh hơn và hữu ích hơn cho thiết kế âm thanh có nhịp.
soundKey	select	Không	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	Đặt giọng nhạc. Chỉ chỉ định khi kết quả cần khớp với hòa âm hoặc giai điệu hiện có; nếu không, để rộng thường an toàn hơn.

Yêu cầu tối thiểu

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

Phản hồi tạo

Điểm cuối tạo trả về ID tác vụ công khai. Hãy thăm dò điểm cuối trạng thái cho đến khi tác vụ succeeded hoặc failed.

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

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found