Chuyển đến nội dung chính

Documentation Index

Fetch the complete documentation index at: https://docs.tokenlab.sh/llms.txt

Use this file to discover all available pages before exploring further.

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

​
model
string
mặc định:"suno_music"
Model để sử dụng: suno_music để tạo nhạc, suno_lyrics chỉ để tạo lời bài hát.
​
prompt
string
bắt buộc
Mô tả về bản nhạc cần tạo. Có thể bao gồm phong cách, tâm trạng, nhạc cụ, v.v.
​
title
string
Tiêu đề cho bài hát được tạo.
​
tags
string
Các thẻ phong cách (ví dụ: “pop, upbeat, electronic”).
​
action
string
Loại tạo: MUSIC (mặc định) hoặc LYRICS.
​
mv
string
Phiên bản model để sử dụng.
​
continue_clip_id
string
ID của một clip trước đó để tiếp tục.
​
continue_at
number
Dấu thời gian (tính bằng giây) để tiếp tục.
​
user
string
Một mã định danh duy nhất cho người dùng cuối.

​
Phản hồi

​
id
string
ID tác vụ để kiểm tra trạng thái.
​
task_id
string
Bí danh của mã tác vụ bất đồng bộ khi được adapter trả về.
​
poll_url
string
URL polling ưu tiên khi có sẵn.
​
status
string
Trạng thái tác vụ: pending, processing, completed, hoặc failed.
​
created
integer
Dấu thời gian Unix khi tạo tác vụ.
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",
    "prompt": "An upbeat electronic dance track with heavy bass",
    "title": "Night Drive",
    "tags": "electronic, EDM, energetic"
  }'

{
  "id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "status": "pending",
  "created": 1706000000,
  "model": "suno_music"
}