Suno API

RouteAPI cung cấp REST API thống nhất cho việc tạo nhạc AI Suno. Tạo nhạc từ văn bản, kéo dài bài hát, nhân bản giọng nói, tách stems và nhiều hơn nữa.

Base URL: https://api.routeapi.ai
Xác thực: Authorization: Bearer sk-xxxx

Tổng quan quy trình

Mô hình bất đồng bộ

Tất cả các thao tác tạo đều tuân theo cùng một mô hình: gửi tác vụ → thăm dò kết quả

Tạo nhạc Suno là bất đồng bộ. Quy trình điển hình:

1. Gửi tác vụ đến /suno/audios → nhận task_id
2. Đợi 2-3 giây trước khi bắt đầu thăm dó
3. Thăm dò mỗi 3-5 giây qua /suno/tasks với action: "retrieve"
4. Khi status trở thành success → lấy audio_url

Trạng thái tác vụ

Trạng thái	Ý nghĩa	Bước tiếp theo
submitted	Đã gửi, đang chờ	Tiếp tục thăm dò
queued	Đang trong hàng đợi	Tiếp tục thăm dò
in_progress	Đang tạo	Tiếp tục thăm dò
success	✅ Hoàn thành	Lấy data.audio_url
failed	❌ Thất bại	Kiểm tra trường error

Bắt đầu nhanh

Bước 1: Gửi tác vụ

curl -X POST "https://api.routeapi.ai/suno/audios" \
  -H "Authorization: Bearer sk-xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "chirp-v5-5",
    "prompt": "A cheerful summer pop song with piano and guitar",
    "async": true
  }'

Bước 2: Thăm dò kết quả

curl -X POST "https://api.routeapi.ai/suno/tasks" \
  -H "Authorization: Bearer sk-xxxx" \
  -H "Content-Type: application/json" \
  -d '{ "action": "retrieve", "id": "task_xxxxx" }'

Bước 3: Lấy âm thanh

{
  "id": "task_xxxxx",
  "status": "success",
  "data": {
    "audio_url": "https://cdn.suno.ai/xxx.mp3",
    "duration": 183.5
  }
}

Mô hình được hỗ trợ

ID mô hình	Độ dài tối đa	Giới hạn lyric	Giới hạn style
chirp-v5-5	8 phút	5000 ký tự	1000 ký tự
chirp-v5	8 phút	5000 ký tự	1000 ký tự
chirp-v4	150 giây	3000 ký tự	200 ký tự

Mẹo

Khi không chắc chắn, hãy sử dụng chirp-v5-5 (mới nhất và mạnh nhất).

POST /suno/audios

Endpoint cốt lõi hỗ trợ tất cả 18 thao tác âm thanh.

Tham số cốt lõi

Trường	Loại	Mặc định	Mô tả
model	string	chirp-v4	Mô hình tạo, khuyến nghị chirp-v5-5
action	string	generate	Loại thao tác
async	boolean	false	Khuyến nghị mạnh true

Các loại hành động

Action	Mô tả	Trường bắt buộc
generate	Tạo nhạc mới từ prompt	prompt
extend	Kéo dài âm thanh hiện có	audio_id + continue_at
cover	Diễn giải lại bài hát hiện có	audio_id
stems	Tách thành giọng hát + nhạc nền	audio_id
remaster	Remaster âm thanh để cải thiện chất lượng	audio_id

Để biết đầy đủ các loại hành động, vui lòng tham khảo tài liệu tiếng Anh hoặc tiếng Trung.

POST /suno/tasks

Truy vấn trạng thái và kết quả tác vụ.

curl -X POST "https://api.routeapi.ai/suno/tasks" \
  -H "Authorization: Bearer sk-xxxx" \
  -H "Content-Type: application/json" \
  -d '{ "action": "retrieve", "id": "task_xxxxx" }'

Các endpoint khác

Endpoint	Phương thức	Mô tả
/suno/lyrics	POST	Tạo lời bài hát
/suno/upload	POST	Tải lên tệp âm thanh bên ngoài
/suno/persona	GET/POST	Quản lý persona giọng nói
/suno/wav	POST	Xuất định dạng WAV

Để biết tham chiếu API đầy đủ, vui lòng tham khảo tài liệu tiếng Anh hoặc tiếng Trung.

Câu hỏi thường gặp

Q: Nên sử dụng mô hình nào?
Sử dụng chirp-v5-5 (mới nhất và mạnh nhất).

Q: Tạo mất bao lâu?
generate thường mất 15-40 giây.

Q: Tôi có thể sử dụng audio_url trực tiếp không?
Có, liên kết CDN sẵn sàng để phát hoặc tải xuống.