sangtao.ai
API key

Tài nguyên

Nhạc nền

Trả về tất cả nhạc nền có sẵn.

GEThttps://api.sangtao.ai/v2/assets/background-tracks

Xác thực

Không cần — endpoint này công khai, gọi không cần API key.

Các bản nhạc nền dùng được. Gửi id của bản nhạc làm backgroundMusic.trackId. Trả về cả danh sách — không có bộ lọc. Không cần API key.

Response

data là danh sách bản nhạc, mỗi bản gồm các field sau:

  • idstring

    ID của bản nhạc, VD: "music_acoustic_warm" — gửi làm backgroundMusic.trackId

  • namestring

    Tên hiển thị

  • audioUrlstring

    File nhạc, để nghe thử (mp3)

  • durationSecondsnumber?

    Thời lượng (giây)

  • bpmnumber?

    Nhịp, số phách mỗi phút

Mã lỗi

MãerrorCodeKhi nào
400VALIDATION_ERRORTham số query có giá trị không hợp lệ — error ghi rõ tham số nào
GET/assets/background-tracks
curl "https://api.sangtao.ai/v2/assets/background-tracks"
{
  "success": true,
  "data": [
    {
      "id": "music_acoustic_warm",
      "name": "Acoustic Warm",
      "audioUrl": "https://cdn.sangtao.ai/motion/system/audio/5fc464fe045b5e772e78c32a08337fa8134cefd52117938f322f8a15c7b5e15d.mp3",
      "durationSeconds": 45.02,
      "bpm": 92.28
    },
    {
      "id": "music_bolero_vn",
      "name": "Bolero Vn",
      "audioUrl": "https://cdn.sangtao.ai/motion/system/audio/92f8b98a65cfbb0b1c356d26428f5955d0635bda627f440a450c69a86f41d136.mp3",
      "durationSeconds": 60.12,
      "bpm": 71.78
    }
  ]
}