跳轉到主要內容

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.

使用 AI 生成音樂和歌詞。這是一個非同步 API。建立回應會返回任務身分，並且在可用時返回優先使用的 poll_url。

​
請求參數

​
model
string
預設值:"suno_music"
要使用的模型：suno_music 用於音樂生成，suno_lyrics 僅用於歌詞。
​
prompt
string
必填
要生成的音樂描述。可以包含風格、心情、樂器等。
​
title
string
生成歌曲的標題。
​
tags
string
風格標籤（例如：“pop, upbeat, electronic”）。
​
action
string
生成類型：MUSIC（預設）或 LYRICS。
​
mv
string
要使用的模型版本。
​
continue_clip_id
string
要續接的前一個片段 ID。
​
continue_at
number
續接的時間戳記（以秒為單位）。
​
user
string
終端用戶的唯一識別碼。

​
回應

​
id
string
用於輪詢狀態的任務 ID。
​
task_id
string
適配器返回時的非同步任務 ID 別名。
​
poll_url
string
可用時返回的優先輪詢 URL。
​
status
string
任務狀態：pending、processing、completed 或 failed。
​
created
integer
任務建立的 Unix 時間戳記。
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",
  "task_id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "poll_url": "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "status": "pending",
  "created": 1706000000,
  "model": "suno_music"
}