Âm nhạc
Tạo Nhạc
Tạo một tác vụ tạo nhạc bằng Suno
Tạo nhạc và lời bài hát bằng AI. Đây là một API bất đồng bộ. Phản hồi tạo trả về danh tính tác vụ và, khi có sẵn, cũng có thể bao gồm poll_url ưu tiên.
Nội dung yêu cầu
suno_musicID mô hình âm nhạc, chẳng hạn suno-music. Để chỉ tạo lời bài hát, chọn mô hình có thao tác công khai hiện tại bao gồm lyrics.
Mô tả âm nhạc hoặc văn bản thay thế. Bắt buộc cho nhạc, lời bài hát, upload-cover, upload-extend và replace-section; tùy chọn cho add-instrumental và tách âm.
Tiêu đề cho bài hát được tạo.
Các thẻ phong cách (ví dụ: "pop, upbeat, electronic").
Phong cách cần tránh. Bắt buộc khi audio_operation là add-instrumental.
Giá trị tùy chọn MUSIC hoặc LYRICS. Chọn mô hình hỗ trợ thao tác công khai tương ứng; trường này không bổ sung khả năng tạo lời cho mô hình chỉ hỗ trợ nhạc.
Bộ chọn phiên bản Suno. Bắt buộc cho tạo nhạc, upload-cover, upload-extend, add-instrumental và thay thế từ audio_url. Bỏ qua với lời bài hát, thay thế từ task_id + audio_id và tách âm. Các giá trị hợp lệ: chirp-v3-5, chirp-v4, chirp-v4-5, chirp-v4.5, chirp-v4-5plus, chirp-v4.5plus, chirp-v4-5all, chirp-v4.5all, chirp-v5, chirp-v5-5, chirp-v5.5.
Đặt thành true để tạo đầu ra nhạc không lời, không có giọng hát.
URL âm thanh tham chiếu hoặc đã tải lên có thể truy cập công khai. Nếu không gửi audio_operation, TokenLab dùng luồng upload-cover.
Thao tác âm thanh: upload-cover, upload-extend, add-instrumental, replace-section, vocal-separate, multi-stem-separation, advanced-split.
vocal-separate, multi-stem-separation và advanced-split yêu cầu task_id + audio_id; advanced-split còn yêu cầu stem_name. upload-extend yêu cầu continue_at lớn hơn 0. add-instrumental yêu cầu audio_url, title, tags và negative_tags.
replace-section yêu cầu prompt, tags, title, infill_start_s, infill_end_s và full_lyrics. Chọn đúng một nguồn: task_id + audio_id, hoặc audio_url + mv. Khoảng thay thế phải dài 6–60 giây.
ID tác vụ nguồn thuộc tổ chức của bạn, dùng để thay thế âm thanh đã tạo hoặc tách âm.
ID âm thanh trả về trong kết quả tác vụ nguồn. Cần đi cùng task_id khi thay thế âm thanh đã tạo hoặc tách âm.
Thời điểm bắt đầu thay thế, tính bằng giây, ít nhất 0. Bắt buộc cho replace-section.
Thời điểm kết thúc thay thế tính bằng giây. Bắt buộc cho replace-section, sau infill_start_s từ 6 đến 60 giây.
Toàn bộ lời bài hát của kết quả. Bắt buộc cho replace-section.
Tên phần âm cần tách. Bắt buộc cho advanced-split.
ID của một clip trước đó để tiếp tục.
Thời điểm nối tiếp tính bằng giây. Bắt buộc và lớn hơn 0 với upload-extend.
prompt tối đa 5000 ký tự; tags và negative_tags mỗi trường tối đa 1000 ký tự. Thao tác và tham số được hỗ trợ tùy thuộc chi tiết hiện tại của mô hình.
Phản hồi
ID tác vụ để kiểm tra trạng thái.
Bí danh của cùng ID tác vụ bất đồng bộ, nếu được trả về.
URL polling ưu tiên khi có sẵn.
Trạng thái tác vụ: pending, processing, completed, hoặc failed.
Thời gian Unix tạo tác vụ, nếu được trả về.
Yêu cầu
curl -X POST "https://api.tokenlab.sh/v1/music/generations" \
-H "Authorization: Bearer sk-your-api-key" \
-H "Content-Type: application/json" \
-d '{
"model": "suno-music",
"mv": "chirp-v4",
"prompt": "An upbeat electronic dance track with heavy bass",
"title": "Night Drive",
"tags": "electronic, EDM, energetic"
}'Phản hồi
{
"id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"task_id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"poll_url": "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"status": "pending",
"model": "suno-music"
}Xác thực
BearerAuth Xác thực bằng Khóa API. Tạo hoặc quản lý khóa API trong Dashboard > API > API Keys.
Vị trí: header
Header
Chính sách phân phối theo yêu cầu. Ghi đè các mặc định của API key và Workspace. Tự động thử TokenLab Verified trước và có thể chuyển đổi một lần sang Official chỉ trước khi xuất, chấp nhận yêu cầu hoặc tạo tài nguyên cố định.
Giá trị hợp lệ
- "auto"
- "verified"
- "official"
Nội dung yêu cầu
application/json
Phản hồi
application/json
application/json