Định dạng nhạc Suno (Âm nhạc)

Xin lưu ý

Giao diện này không phải là giao diện Suno chính thức, mà là proxy Suno giao diện được triển khai dựa trên dự án nguồn mở Suno-API by author Plato.

Chúng tôi rất biết ơn sự đóng góp của tác giả, cho phép chúng tôi dễ dàng sử dụng các tính năng mạnh mẽ của Suno. Nếu có thời gian xin hãy tặng tác giả một Ngôi sao.

📝 Giới thiệu

Suno Music API cung cấp một loạt chức năng tạo và xử lý nhạc, bao gồm:

Tạo bài hát dựa trên lời nhắc (Chế độ truyền cảm hứng, Chế độ tùy chỉnh)
Tiếp tục viết các bài hát hiện có
Nối nhiều đoạn âm thanh
Tạo lời bài hát
Tải lên âm thanh

Thông qua API, bạn có thể dễ dàng tích hợp khả năng tạo nhạc AI vào ứng dụng của mình.

💡 Yêu cầu Ví dụ

Tạo bài hát ✅

curl --location 'https://88api.ai/suno/submit/music' \
--header 'Authorization: Bearer $API_KEY' \
--header 'Content-Type: application/json' \
--data '{
    "prompt":"[Verse]\nWalking down the streets\nBeneath the city lights\nNeon signs flickering\nLighting up the night\nHeart beating faster\nLike a drum in my chest\nI'\''m alive in this moment\nFeeling so blessed\n\nStilettos on the pavement\nStepping with grace\nSurrounded by the people\nMoving at their own pace\nThe rhythm of the city\nIt pulses in my veins\nLost in the energy\nAs my worries drain\n\n[Verse 2]\nConcrete jungle shining\nWith its dazzling glow\nEvery corner hiding secrets that only locals know\nA symphony of chaos\nBut it'\''s music to my ears\nThe hustle and the bustle\nWiping away my fears",
    "tags":"emotional punk",
    "mv":"chirp-v4",
    "title":"City Lights"
}'

Response Example:

{
  "code": "success",
  "message": "",
  "data": "736a6f88-bd29-4b1e-b110-37132a5325ac"
}

Tạo lời bài hát ✅

curl --location 'https://88api.ai/suno/submit/lyrics' \
--header 'Authorization: Bearer $API_KEY' \
--header 'Content-Type: application/json' \
--data '{
    "prompt":"dance"
}'

Response Example:

{
  "code": "success",
  "message": "",
  "data": "736a6f88-bd29-4b1e-b110-37132a5325ac"
}

Tải lên âm thanh ❌

curl --location 'https://88api.ai/suno/uploads/audio-url' \
--header 'Authorization: Bearer $API_KEY' \
--header 'Content-Type: application/json' \
--data '{
    "url":"http://cdnimg.example.com/ai/2024-06-18/d416d9c3c34eb22c7d8c094831d8dbd0.mp3"
}'

Response Example:

{
  "code": "success",
  "message": "",
  "data": "736a6f88-bd29-4b1e-b110-37132a5325ac"
}

Nối bài hát ❌

curl --location 'https://88api.ai/suno/submit/concat' \
--header 'Authorization: Bearer $API_KEY' \
--header 'Content-Type: application/json' \
--data '{
    "clip_id":"extend song ID",
    "is_infill": false
}'

Response Example:

{
  "code": "success",
  "message": "",
  "data": "736a6f88-bd29-4b1e-b110-37132a5325ac"
}

Trạng thái tác vụ truy vấn ✅

Truy vấn hàng loạt

curl --location 'https://88api.ai/suno/fetch' \
--header 'Authorization: Bearer $API_KEY' \
--header 'Content-Type: application/json' \
--data '{
    "ids":["task_id"],
    "action":"MUSIC"
}'

Response Example:

{
  "code": "success",
  "message": "",
  "data": [
    {
      "task_id": "346c5d10-a4a1-4f49-a851-66a7dae6cfaf",
      "notify_hook": "",
      "action": "MUSIC",
      "status": "IN_PROGRESS",
      "fail_reason": "",
      "submit_time": 1716191749,
      "start_time": 1716191786,
      "finish_time": 0,
      "progress": "0%",
      "data": [
        {
          "id": "e9893d04-6a63-4007-8473-64b706eca4d1",
          "title": "Electric Dance Party",
          "status": "streaming",
          "metadata": {
            "tags": "club banger high-energy edm",
            "prompt": "omitted",
            "duration": null,
            "error_type": null,
            "error_message": null,
            "audio_prompt_id": null,
            "gpt_description_prompt": "miku dance"
          },
          "audio_url": "https://audiopipe.suno.ai/?item_id=e9893d04-6a63-4007-8473-64b706eca4d1",
          "image_url": "https://cdn1.suno.ai/image_e9893d04-6a63-4007-8473-64b706eca4d1.png",
          "video_url": "",
          "model_name": "chirp-v3",
          "image_large_url": "https://cdn1.suno.ai/image_large_e9893d04-6a63-4007-8473-64b706eca4d1.png",
          "major_model_version": "v3"
        }
      ]
    }
  ]
}

Truy vấn đơn

curl --location 'https://88api.ai/suno/fetch/{{task_id}}' \
--header 'Authorization: Bearer $API_KEY'

Response Example:

{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "f4a94d75-087b-4bb1-bd45-53ba293faf96",
    "notify_hook": "",
    "action": "LYRICS",
    "status": "SUCCESS",
    "fail_reason": "",
    "submit_time": 1716192124,
    "start_time": 1716192124,
    "finish_time": 1716192124,
    "progress": "100%",
    "data": {
      "id": "f4a94d75-087b-4bb1-bd45-53ba293faf96",
      "text": "omitted",
      "title": "Electric Fantasy",
      "status": "complete"
    }
  }
}

📮 Yêu cầu

Tất cả các yêu cầu phải bao gồm thông tin xác thực trong tiêu đề yêu cầu:

Authorization: Bearer $API_KEY

Điểm cuối

Tạo bài hát

POST /suno/submit/music

Tạo bài hát mới, hỗ trợ chế độ truyền cảm hứng, chế độ tùy chỉnh và tiếp tục.

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

POST /suno/submit/lyrics

Tạo lời bài hát dựa trên lời nhắc.

Tải lên âm thanh

POST /suno/uploads/audio-url

Tải lên tập tin âm thanh.

Nối bài hát

POST /suno/submit/concat

Ghép nhiều đoạn âm thanh thành một bài hát hoàn chỉnh.

Trạng thái tác vụ truy vấn hàng loạt

POST /suno/fetch

Hàng loạt nhận được trạng thái và kết quả của nhiều nhiệm vụ.

Truy vấn trạng thái tác vụ đơn

GET /suno/fetch/{{task_id}}

Truy vấn trạng thái và kết quả của một nhiệm vụ.

Thông số nội dung yêu cầu

Tạo bài hát

`prompt`

Loại: Chuỗi
Bắt buộc: Chế độ cảm hứng không yêu cầu, chế độ tùy chỉnh yêu cầu
Mô tả:Nội dung lời bài hát, cần được cung cấp ở chế độ tùy chỉnh

`mv`

Loại: Chuỗi
Bắt buộc: Không
Mô tả: Phiên bản model, giá trị tùy chọn: chirp-v3-0, chirp-v3-5, mặc định là chirp-v3-0

`title`

Loại: Chuỗi
Bắt buộc: Chế độ cảm hứng không yêu cầu, chế độ tùy chỉnh yêu cầu
Mô tả: Tên bài hát, cần được cung cấp ở chế độ tùy chỉnh

`tags`

Loại: Chuỗi
Bắt buộc: Chế độ cảm hứng không yêu cầu, chế độ tùy chỉnh yêu cầu
Mô tả: Thẻ kiểu bài hát, được phân tách bằng dấu phẩy, cần được cung cấp ở chế độ tùy chỉnh

`make_instrumental`

Kiểu: Boolean
Bắt buộc: Không
Mô tả:Tạo ra âm nhạc thuần khiết, chân chính có nghĩa là tạo ra âm nhạc thuần khiết

`task_id`

Loại: Chuỗi
Bắt buộc: Bắt buộc khi tiếp tục
Mô tả: ID nhiệm vụ của bài hát sẽ được tiếp tục

`continue_at`

Loại: Phao
Bắt buộc: Bắt buộc khi tiếp tục
Mô tả: Viết tiếp từ giây nào của bài hát

`continue_clip_id`

Loại: Chuỗi
Bắt buộc: Bắt buộc khi tiếp tục
Mô tả: ID clip của bài hát sẽ được làm tiếp

`gpt_description_prompt`

Loại: Chuỗi
Bắt buộc: Bắt buộc ở chế độ hít vào, không bắt buộc ở các chế độ khác
Description: Văn bản mô tả nguồn cảm hứng

`notify_hook`

Loại: Chuỗi
Bắt buộc: Không
Mô tả:Địa chỉ gọi lại để hoàn thành việc tạo bài hát

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

`prompt`

Loại: Chuỗi
Yêu cầu: Có
Mô tả:Chủ đề hoặc từ khóa của lời bài hát

`notify_hook`

Loại: Chuỗi
Bắt buộc: Không
Mô tả:Địa chỉ gọi lại để hoàn thành tạo lời bài hát

Tải lên âm thanh

`url`

Loại: Chuỗi
Yêu cầu: Có
Mô tả: Địa chỉ URL của file âm thanh cần upload

Nối bài hát

`clip_id`

Loại: Chuỗi
Yêu cầu: Có
Mô tả:ID của đoạn bài hát cần nối

`is_infill`

Kiểu: Boolean
Bắt buộc: Không
Mô tả: Cho dù đó là chế độ điền

Truy vấn tác vụ

`ids`

Kiểu:Chuỗi[]
Yêu cầu: Có
Mô tả: Danh sách ID nhiệm vụ cần truy vấn

`action`

Loại: Chuỗi
Bắt buộc: Không
Mô tả:Loại tác vụ, giá trị tùy chọn: NHẠC, LYRICS

📥 Phản hồi

Tất cả các giao diện đều trả về phản hồi có định dạng JSON thống nhất:

{
  "code": "success",
  "message": "",
  "data": "{{RESULT}}"
}

###Phản hồi thành công

Trường phản hồi cơ bản

`code`

Loại: Chuỗi
Mô tả: Trạng thái yêu cầu, thành công nghĩa là thành công

`message`

Loại: Chuỗi
Mô tả:Thông báo lỗi khi yêu cầu không thành công

`data`

Loại: Khác nhau cho các giao diện khác nhau
Mô tả: Trả về dữ liệu khi request thành công
Tạo giao diện tạo bài hát, lời bài hát, upload âm thanh, ghép bài hát: trả về chuỗi ID tác vụ
Giao diện truy vấn tác vụ: trả về đối tượng tác vụ hoặc mảng đối tượng tác vụ

Đối tượng liên quan đến nhiệm vụ

Đối tượng tác vụ

`task_id`

Loại: Chuỗi
Mô tả: ID nhiệm vụ

`notify_hook`

Loại: Chuỗi
Mô tả:Địa chỉ gọi lại sau khi hoàn thành nhiệm vụ

`action`

Loại: Chuỗi
Mô tả:Loại tác vụ, giá trị tùy chọn: NHẠC, LYRICS

`status`

Loại: Chuỗi
Mô tả:Trạng thái nhiệm vụ, giá trị tùy chọn: IN_PROGRESS, SUCCESS, FAIL

`fail_reason`

Loại: Chuỗi
Mô tả:Lý do thất bại trong nhiệm vụ

`submit_time`

Loại: Số nguyên
Mô tả: Dấu thời gian nộp nhiệm vụ

`start_time`

Loại: Số nguyên
Mô tả: Dấu thời gian bắt đầu nhiệm vụ

`finish_time`

Loại: Số nguyên
Mô tả: Dấu thời gian kết thúc nhiệm vụ

`progress`

Loại: Chuỗi
Mô tả: Phần trăm tiến độ nhiệm vụ

`data`

Loại: Khác nhau đối với các loại nhiệm vụ khác nhau
Sự miêu tả:
Nhiệm vụ tạo nhạc: mảng đối tượng bài hát
Nhiệm vụ tạo lời bài hát: đối tượng lời bài hát

Đối tượng bài hát

`id`

Loại: Chuỗi
Mô tả: ID bài hát

`title`

Loại: Chuỗi
Mô tả: Tên bài hát

`status`

Loại: Chuỗi
Mô tả: Trạng thái bài hát

`metadata`

Loại: Đối tượng
Mô tả:Siêu dữ liệu bài hát
tags:Thẻ phong cách bài hát
lời nhắc: Lời bài hát được sử dụng để tạo bài hát
thời lượng: Thời lượng bài hát
error_type: Loại lỗi
error_message: Thông báo lỗi
audio_prompt_id:ID lời nhắc âm thanh
gpt_description_prompt:Mô tả nguồn cảm hứng

`audio_url`

Loại: Chuỗi
Mô tả: Địa chỉ URL của âm thanh bài hát

`image_url`

Loại: Chuỗi
Mô tả: Địa chỉ URL ảnh bìa bài hát

`video_url`

Loại: Chuỗi
Mô tả: Địa chỉ URL của video bài hát

`model_name`

Loại: Chuỗi
Mô tả: Tên model dùng để tạo bài hát

`major_model_version`

Loại: Chuỗi
Mô tả: Phiên bản mô hình chính

Đối tượng lời bài hát

`id`

Loại: Chuỗi
Mô tả:ID lời bài hát

`text`

Loại: Chuỗi
Mô tả:Nội dung lời bài hát

`title`

Loại: Chuỗi
Mô tả: Tiêu đề lời bài hát

`status`

Loại: Chuỗi
Mô tả: Trạng thái lời bài hát

🌟 Các phương pháp hay nhất

Cung cấp lời nhắc tạo bài hát hoặc lời bài hát càng chi tiết và cụ thể càng tốt, tránh những lời nhắc quá chung chung hoặc trừu tượng
Khi truy vấn trạng thái nhiệm vụ, khoảng thời gian bỏ phiếu được khuyến nghị là 2-5 giây để tránh bỏ phiếu quá mức
Chế độ truyền cảm hứng chỉ cần cung cấp tham số gpt_description_prompt, API sẽ tự động tạo lời bài hát, tiêu đề, thẻ, v.v.
Chế độ tùy chỉnh yêu cầu các tham số lời nhắc, tiêu đề, thẻ để có thể kiểm soát bài hát nhiều hơn
Hãy thử sử dụng model mới nhất (chẳng hạn như chirp-v4), hiệu quả sẽ tốt hơn
Sử dụng chức năng thông báo gọi lại (tham số notify_hook) có thể giảm tần suất bỏ phiếu và nâng cao hiệu quả
Chức năng nối và nối âm nhạc có thể tạo ra các tác phẩm phong phú và hoàn chỉnh hơn trên bản nhạc gốc
Chú ý đến các trường hợp ngoại lệ và lỗi có thể xảy ra, chẳng hạn như thời gian chờ mạng, lỗi xác thực tham số, v.v.

Mục lục