API gợi ý prompt

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

Mô tả endpoint

Endpoint gợi ý prompt trả về mô tả bài hát, chủ đề lời và gợi ý thẻ phong cách ngẫu nhiên. Phù hợp cho nút "cảm hứng ngẫu nhiên" và "làm mới thẻ".

Endpoint: POST /api/prompts/suggestions

Tính phí: Miễn phí trong hạn mức (tối đa 10 lần 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 ¥ 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 có X-Suno-Helper-Free: false cùng X-Suno-Helper-Over-Limit: minute (hoặc day), nhờ đó client có thể báo rằng lần gọi này đã bị tính phí.

Mô hình khuyến nghị: 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

Ví dụ yêu cầu

curl -X POST https://www.suno-api.io/api/prompts/suggestions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6"
  }'

Phản hồi

{
  "code": 200,
  "message": "success",
  "data": {
    "prompts": ["A dreamy synth-pop track about city lights after rain"],
    "lyrics_prompts": ["Viết lời tiếng Việt về đêm, sự gặp lại và nuối tiếc"],
    "tags": ["dreamy synth-pop", "warm piano", "male vocal"],
    "is_pending_personalization": false
  }
}

Mô tả trường