API tạo lời bài hát

Cập nhật 2026-09-18 · nhóm Suno-API

Mô tả endpoint

Tạo lời bài hát giúp tạo hoặc viết lại lời dựa trên chủ đề, ngữ cảnh lời có sẵn và yêu cầu về phong cách. Endpoint này đã được nâng cấp lên hợp đồng tạo lời mới nhất và dùng trực tiếp được cho chế độ chuyên nghiệp.

Endpoint: POST /api/lyrics/generate

Tính phí: Miễn phí trong hạn mức (tối đa 10 lần gọi mỗi phút và 300 lần mỗi ngày cho mỗi người dùng); vượt hạn mức miễn phí thì 0,1 CNY mỗi lần gọi.

Nhận biết vượt hạn mức: khi vượt hạn mức miễn phí, yêu cầu vẫn chạy bình thường và header phản hồi kèm X-Suno-Helper-Free: false và X-Suno-Helper-Over-Limit: minute (hoặc day), nhờ đó client có thể thông báo lần gọi này đã bị tính phí.

Mô hình đề xuất: suno-v6. Có thể dùng suno-v6, suno-v6-wild hoặc suno-v6-mini.

Xác thực

Tham số yêu cầu

instruction cũng chấp nhận hai trường cũ theme và prompt. metadata.lyrics_model mặc định là default, metadata.enable_thinking mặc định là false.

Kiểm soát ngôn ngữ

Endpoint này không có trường yêu cầu language riêng. Ngôn ngữ của lời do nội dung instruction quyết định; style chỉ đóng vai trò hỗ trợ.

Để có lời tiếng Trung, hãy nêu rõ ngôn ngữ đích trong instruction, ví dụ:

{
  "model": "suno-v6",
  "instruction": "请用中文写歌词，主题是夏夜海边重逢",
  "style": "Mandopop, 中文流行"
}

Bạn cũng có thể viết "Write the lyrics in Chinese about ...". Để có lời tiếng Anh, hãy viết "请用英文写歌词" hoặc "Write the lyrics in English". Nếu chỉ gửi chủ đề tiếng Anh mà không nêu ngôn ngữ đích, kết quả có thể là tiếng Anh.

Ví dụ yêu cầu

curl -X POST https://www.suno-api.io/api/lyrics/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "instruction": "Lời tiếng Việt về mùa tốt nghiệp và khởi đầu mới",
    "style": "pop rock, chân thành, điệp khúc dễ nhớ",
    "title": "Khởi đầu mới",
    "metadata": {
      "lyrics_model": "default",
      "enable_thinking": false
    }
  }'

Phản hồi

{
  "code": 200,
  "message": "success",
  "data": {
    "lyrics": "[Verse]\nGió lướt qua sân trường\nTa vẫy tay chào ngày hôm qua",
    "edited_lyrics": "[Verse]\nGió lướt qua sân trường\nTa vẫy tay chào ngày hôm qua",
    "lyrics_id": "lyrics_id",
    "lyrics_request_id": "lyrics_request_id"
  }
}

edited_lyrics là lời hoàn chỉnh cần điền vào ô lời bài hát. lyrics_id và lyrics_request_id dùng để theo dõi và có thể rỗng tùy theo phản hồi của endpoint; đừng coi chúng là ID bài hát.

Ghi chú tương thích

• Hai trường cũ theme và prompt vẫn dùng được và được ánh xạ thành instruction.
• Chuỗi endpoint dự án lời / người viết lời đã ngừng: nếu cần lưu kết quả tạo, hãy tự lưu edited_lyrics mà endpoint trả về.