Platfrom Suno là nền tảng chuyên tạo nhạc và ca khúc bằng trí tuệ nhân tạo, cho phép người dùng tạo ra những bản nhạc có lời với phong cách và thể loại mong muốn chỉ bằng cách nhập vào một đoạn mô tả ngắn gọn. Nhóm phát triển của Suno bao gồm các chuyên gia đến từ Meta, TikTok, Kensho, v.v., với mục tiêu giúp mọi người đều có thể sáng tác âm nhạc mà không cần bất kỳ thiết bị nào.
Phiên bản mới nhất của Suno đã nâng cấp mô hình tạo nhạc lên phiên bản V3, hỗ trợ tạo ra những bản nhạc kéo dài tới hai phút.
Tuy nhiên, Suno chính thức chưa cung cấp API riêng. Tuy nhiên, AceDataCloud đã phát triển một API tương thích với Suno, cho phép bạn dễ dàng tạo nhạc theo yêu cầu.
Đăng ký và sử dụng
Để sử dụng API Suno Audios, bạn hãy truy cập trang Suno Audios Generation API và nhấn vào nút "Acquire" để lấy thông tin xác thực cần thiết:
Nếu bạn chưa đăng nhập hoặc đăng ký, hệ thống sẽ tự động chuyển hướng đến trang đăng nhập để bạn thực hiện. Sau khi hoàn tất, bạn sẽ quay lại trang hiện tại.
Lần đầu tiên bạn xin cấp quyền sẽ được tặng một lượng tài nguyên miễn phí để sử dụng.
Cách dùng cơ bản
Bạn chỉ cần nhập một đoạn văn bản mô tả như "một bài hát về Giáng sinh", sau đó nhấn thử nghiệm để kiểm tra API. Sau khoảng 1-2 phút, kết quả trả về sẽ giống như sau:
{
"success": true,
"data": [
{
"id": "2f16f7bc-4135-42c6-b3c5-6d6c49dc8cd5",
"title": "Winter Wonderland",
"image_url": "https://cdn1.suno.ai/image_2f16f7bc-4135-42c6-b3c5-6d6c49dc8cd5.png",
"lyric": "[Verse]\nSnowflakes falling all around\nGlistening white\nCovering the ground\nChildren laughing\nFull of delight\nIn this winter wonderland tonight\nSanta's sleigh\nUp in the sky\nRudolph's nose shining bright\nOh my\nHear the jingle bells\nRinging so clear\nBringing joy and holiday cheer\n[Verse 2]\nRoasting chestnuts by the fire's glow\nChristmas lights\nThey twinkle and show\nFamilies gathering with love and cheer\nSpreading warmth to everyone near",
"audio_url": "https://cdn1.suno.ai/2f16f7bc-4135-42c6-b3c5-6d6c49dc8cd5.mp3",
"video_url": "https://cdn1.suno.ai/2f16f7bc-4135-42c6-b3c5-6d6c49dc8cd5.mp4",
"created_at": "2024-05-10T16:21:37.624Z",
"model": "chirp-v3",
"prompt": "A song for Christmas",
"style": "holiday"
},
{
"id": "5dca232b-17cc-4896-a2d1-4b59178bf410",
"title": "Winter Wonderland",
"image_url": "https://cdn1.suno.ai/image_5dca232b-17cc-4896-a2d1-4b59178bf410.png",
"lyric": "[Verse]\nSnowflakes falling all around\nGlistening white\nCovering the ground\nChildren laughing\nFull of delight\nIn this winter wonderland tonight\nSanta's sleigh\nUp in the sky\nRudolph's nose shining bright\nOh my\nHear the jingle bells\nRinging so clear\nBringing joy and holiday cheer\n[Verse 2]\nRoasting chestnuts by the fire's glow\nChristmas lights\nThey twinkle and show\nFamilies gathering with love and cheer\nSpreading warmth to everyone near",
"audio_url": "https://cdn1.suno.ai/5dca232b-17cc-4896-a2d1-4b59178bf410.mp3",
"video_url": "https://cdn1.suno.ai/5dca232b-17cc-4896-a2d1-4b59178bf410.mp4",
"created_at": "2024-05-10T16:21:37.624Z",
"model": "chirp-v3",
"prompt": "A song for Christmas",
"style": "holiday"
}
]
}
Bạn sẽ nhận được hai bản nhạc với đầy đủ thông tin như tiêu đề, hình ảnh, lời bài hát, tệp âm thanh và video.
Các trường dữ liệu:
- success: Trạng thái thành công của quá trình tạo nhạc (true nếu thành công).
- data: Danh sách các bản nhạc được tạo, mỗi bản chứa:
- id: Mã định danh của bài hát
- title: Tiêu đề bài hát
- image_url: Đường dẫn hình ảnh bìa
- lyric: Lời bài hát
- audio_url: Đường dẫn tệp âm thanh MP3
- video_url: Đường dẫn tệp video MP4
- created_at: Thời gian tạo
- model: Mô hình sử dụng (thường là chirp-v3)
- style: Phong cách nhạc
Tùy chỉnh tạo nhạc
Nếu bạn muốn tự viết lời bài hát, hãy nhập nội dung lời như sau:
[Verse]
Snowflakes falling all around
Glistening white
Covering the ground
Children laughing
Full of delight
In this winter wonderland tonight
Santa's sleigh
Up in the sky
Rudolph's nose shining bright
Oh my
Hear the jingle bells
Ringing so clear
Bringing joy and holiday cheer
[Verse 2]
Roasting chestnuts by the fire's glow
Christmas lights
They twinkle and show
Families gathering with love and cheer
Spreading warmth to everyone near
Lưu ý rằng
\nlà ký tự xuống dòng. Nếu bạn chưa biết cách viết lời bài hát, có thể sử dụng API tạo lời bài hát do AceDataCloud cung cấp.
Để tạo nhạc tùy chỉnh, bạn cần truyền các tham số sau:
- lyric: Nội dung lời bài hát
- custom: Đặt thành
trueđể kích hoạt chế độ tùy chỉnh - file: Tên bài hát
- style: Phong cách nhạc (tùy chọn)
Mã lệnh mẫu:
curl -X POST 'https://api.acedata.cloud/suno/audios' \
-H 'authorization: Bearer {token}' \
-H 'accept: application/json' \
-H 'content-type: application/json' \
-d '{
"lyric": "[Verse]\\nSnowflakes falling all around\\nGlistening white\\nCovering the ground\\nChildren laughing\\nFull of delight\\nIn this winter wonderland tonight\\nSanta's sleigh\\nUp in the sky\\nRudolph's nose shining bright\\nOh my\\nHear the jingle bells\\nRinging so clear\\nBringing joy and holiday cheer\\n[Verse 2]\\nRoasting chestnuts by the fire's glow\\nChristmas lights\\nThey twinkle and show\\nFamilies gathering with love and cheer\\nSpreading warmth to everyone near",
"custom": true
}'
Quá trình tạo sẽ hoạt động tương tự.
Tiếp tục tạo nhạc
Để mở rộng một bản nhạc đã tạo, bạn có thể đặt tham số action thành extend, đồng thời cung cấp ID của bản nhạc cần tiếp tục. ID này có thể lấy từ phần tạo nhạc cơ bản như trên.
Ví dụ, nếu ID bài hát là:
"id": "b9e9fa11-0bf3-47cd-a3d7-85735aee3e07"
Bạn có thể gửi yêu cầu với các tham số sau:
import requests
url = "https://api.acedata.cloud/suno/audios"
headers = {
"accept": "application/json",
"authorization": "Bearer {token}",
"content-type": "application/json"
}
payload = {
"action": "extend",
"prompt": "A song for Christmas",
"audio_id": "b9e9fa11-0bf3-47cd-a3d7-85735aee3e07",
"continue_at": 10,
"style": "cute",
"lyric": "la la la"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)
Kết quả trả về sẽ chứa các bản nhạc mới được mở rộng, ví dụ:
{
"success": true,
"task_id": "baf55c32-1207-4bdf-bd00-32a864f0474d",
"data": [
{
"id": "5a3d0054-a6c5-43a9-a348-eae22d1f0efe",
"title": "",
"image_url": "https://cdn2.suno.ai/image_5a3d0054-a6c5-43a9-a348-eae22d1f0efe.jpeg",
"lyric": "la la la",
"audio_url": "https://cdn1.suno.ai/5a3d0054-a6c5-43a9-a348-eae22d1f0efe.mp3",
"video_url": "https://cdn1.suno.ai/5a3d0054-a6c5-43a9-a348-eae22d1f0efe.mp4",
"created_at": "2024-07-25T11:15:49.320Z",
"model": "chirp-v3.5",
"prompt": null,
"style": "cute",
"duration": 7.96
}
]
}
Gọi lại bất đồng bộ
Do quá trình tạo nhạc mất thời gian (khoảng 1-2 phút), để tránh chờ đợi lâu, API hỗ trợ gọi lại bất đồng bộ.
Cách hoạt động:
- Khi gửi yêu cầu, bạn thêm trường
callback_url. - API trả về ngay lập tức với
task_id. - Sau khi hoàn thành, kết quả sẽ được gửi về
callback_urldưới dạng JSON, kèm theotask_id.
Ví dụ, bạn dùng URL công cộng như https://webhook.site/ để nhận dữ liệu:
{
"task_id": "44472ab8-783b-4054-b861-5bf14e462f60"
}
Sau đó, bạn có thể kiểm tra tại https://webhook.site/ để xem kết quả:
{
"success": true,
"task_id": "44472ab8-783b-4054-b861-5bf14e462f60",
"data": [
{
"id": "da4324e5-84b2-484b-b0e9-dd261381c594",
"title": "Winter Whispers",
"image_url": "https://cdn1.suno.ai/image_da4324e5-84b2-484b-b0e9-dd261381c594.png",
"lyric": "[Verse]\nSnow falling gently from the sky\nChildren giggling as they pass by\nFire crackling\nCozy and warm\nChristmas spirit begins to swarm\n[Verse 2]\nTwinkling lights\nA sight to behold\nStockings hung\nWaiting to be filled with gold\nGifts wrapped with love\nPiled high\nExcitement in the air\nYou can't deny\n[Chorus]\nWinter whispers in the wind\nJoy and love it brings\nLet's celebrate this season\nWith the ones we're missing",
"audio_url": "https://cdn1.suno.ai/da4324e5-84b2-484b-b0e9-dd261381c594.mp3",
"video_url": "https://cdn1.suno.ai/da4324e5-84b2-484b-b0e9-dd261381c594.mp4",
"created_at": "2024-05-11T07:33:05.430Z",
"model": "chirp-v3",
"prompt": "A song for Christmas",
"style": "pop"
}
]
}
Trường task_id giúp bạn liên kết kết quả với yêu cầu ban đầu.