API Crop (cắt)

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

Mô tả endpoint

Crop giữ lại một khoảng thời gian của bài hát đã có và tạo ra bản cắt mới.

Endpoint: POST /api/music/crop

Tính phí: Có phí, tính theo mô hình yêu cầu; số tiền thực trừ tuân theo cấu hình giá trong phần quản trị.

Mô hình khuyến nghị: suno-v6. Có thể dùng suno-v6, suno-v6-wild hoặc suno-v6-mini.

Thời gian chờ và timeout (quan trọng): đây là endpoint đồng bộ — đơn chỉ được tiếp nhận và đưa vào tạo nhạc khi phản hồi trả về. Theo đo đạc, phần lớn yêu cầu trả về trong 1-3 giây, khoảng 10% mất hơn 30 giây và lâu nhất khoảng 230 giây. Hãy đặt timeout phía client từ 300 giây trở lên; không nhận được phản hồi không có nghĩa là chưa tạo gì, và đừng thử lại ngay sau khi timeout (sẽ trùng đơn và bị tính phí hai lần). Nếu kết nối bị ngắt, hãy kiểm tra lại sau bằng GET /api/music/songs. Xem "Thời gian chờ và thiết lập timeout" trong Tổng quan API mới.

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/music/crop \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "source_clip_id": "source_song_id",
    "crop_start_s": 10,
    "crop_end_s": 48,
    "song_title": "Bản cắt"
  }'

Phản hồi

{
  "code": 200,
  "message": "success",
  "data": {
    "clips": [
      {
        "song_id": "result_song_id",
        "song_title": "Bản cắt",
        "status": "processing"
      }
    ]
  }
}

Một lần gọi trả về 1 kết quả (thao tác chỉnh sửa không tạo 2 bài). Hãy lưu clips[].song_id rồi gọi API truy vấn bài hát đến khi completed. Đôi khi phản hồi đầu tiên chưa đăng ký song_id tra được; chờ một lát rồi tra lại.

Lưu ý

• Khoảng cần giữ phải thoả 0 <= crop_start_s < crop_end_s và nằm trong thời lượng bài hát nguồn.
• Khác với cắt, muốn xoá một đoạn hãy dùng API xoá đoạn.