Tài liệu API Suno — tạo nhạc từ prompt (V5 / V5.5), kèm giá

Suno là model âm nhạc AI hàng đầu — tạo các bài hát hoàn chỉnh với giọng hát, lời và phần nhạc từ prompt văn bản. Suno API (Suno V5 và V5.5 trên Kunavo) thực hiện việc này theo chương trình qua POST /v1/audio/music, trả về các bản nhạc audio được lưu trữ bằng một bearer token. Đây là tài liệu thực tế: cấu trúc yêu cầu, giá và mô hình bất đồng bộ cho môi trường production.

Gọi Suno API

Tạo key tại /app/keys và POST một prompt. Một yêu cầu trả về khoảng hai biến thể bài nhạc; quá trình tạo mất từ vài chục giây đến vài phút:

import os

import requests

API_KEY = os.environ["KUNAVO_API_KEY"]

# Music generation is a POST to /v1/audio/music. One request returns
# ~2 track variations; generation takes tens of seconds to a couple of minutes.
resp = requests.post(
    "https://api.kunavo.com/v1/audio/music",
    headers={"Authorization": f"Bearer {API_KEY}"},
    json={
        "model": "suno-v5",                 # or suno-v5-5
        "prompt": "uplifting lo-fi hip hop with mellow piano and vinyl crackle",
        "instrumental": False,              # set True to skip vocals
    },
    timeout=300,
)
for track in resp.json()["data"]:
    print(track["url"])

Toàn bộ tham số và vòng đời task bất đồng bộ được trình bày trong tài liệu tham chiếu music API.

Giá

Suno tính phí theo mỗi yêu cầu tạo (không phải theo từng bài nhạc), vì vậy khoảng 2 biến thể nhận được chỉ tính một khoản phí. Mức giá hiện tại nằm trên trang của từng model. Bản thân Suno không công bố giá API theo yêu cầu — API riêng của họ là chương trình chỉ dành cho đối tác, không có giá công khai — nên bảng chỉ hiển thị khoản Kunavo tính.

Trả theo mức sử dụng từ khoản nạp tối thiểu $10, số dư không bao giờ hết hạn, các lần tạo thất bại không bị tính phí. Ước tính khối lượng công việc lớn hơn bằng bộ tính chi phí.

Chế độ tùy chỉnh: lời của riêng bạn

Thay vì prompt thông thường, hãy cung cấp lyrics, mô tả style và title để kiểm soát hoàn toàn, hoặc đặt instrumental: true để bỏ qua giọng hát hoàn toàn:

# Custom mode: supply your own lyrics + a style, instead of a plain prompt.
curl https://api.kunavo.com/v1/audio/music \
  -H "Authorization: Bearer $KUNAVO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v5-5",
    "lyrics": "[Verse]\nCity lights blur into the rain...",
    "style": "synthwave, 110 bpm, female vocal",
    "title": "Neon Rain"
  }'

Xử lý bất đồng bộ trong môi trường production

Việc tạo nhạc không diễn ra tức thì, vì vậy ở quy mô lớn hãy gửi task và thăm dò kết quả thay vì giữ kết nối — tài liệu music trình bày vòng đời task, việc thăm dò và phân phối webhook. URL kết quả là vĩnh viễn sau khi hoàn tất.

Kunavo so với việc dùng Suno trực tiếp

Sản phẩm riêng của Suno là gói đăng ký có hạn mức tín dụng, không phải API trả theo mức sử dụng — đó chính là lý do các nhà phát triển tìm kiếm “Suno API”:

Nếu bạn tạo nhạc bên trong một sản phẩm, thanh toán theo lượt và endpoint thực là điều quan trọng. Nếu một người dùng trình duyệt để tự tạo track, gói đăng ký riêng của Suno là lựa chọn đơn giản hơn.

Suno API và Udio API

Udio là một họ công nghệ tạo nhạc hàng đầu khác, và “Udio API” là truy vấn song song phổ biến. Khác biệt thực tế hiện nay: quyền truy cập API của Udio đi qua các phương thức thử nghiệm của bên thứ ba mà không có giá công khai ổn định, trong khi Suno V5 / V5.5 trên Kunavo là endpoint được hỗ trợ với mức giá cố định, công khai ($0,09 cho mỗi yêu cầu tạo). Nếu cần tạo nhạc đáng tin cậy trong production — Suno V5 API ở đây là lựa chọn ổn định; chúng tôi sẽ đánh giá Udio khi upstream ổn định xuất hiện.

Ngoài âm nhạc

Cùng một key có thể truy cập văn bản (Claude, GPT), hình ảnh (Nano Banana, GPT-Image-2) và video (Veo 3, Seedance 2, Wan 2.7) — vì vậy bạn có thể xây dựng toàn bộ pipeline: viết kịch bản bằng LLM, tạo hình ảnh, thêm nhạc nền Suno. Xem hướng dẫn AI đa phương thức để biết các quy trình hình ảnh → video → nhạc.

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