TokenLab
Dapatkan kunci API
DokumentasiReferensi APIIntegrasi

Musik

Buat Musik

Membuat tugas pembuatan musik menggunakan Suno

POST
/v1/music/generations

Hasilkan musik dan lirik menggunakan AI. Ini adalah API asinkron. Respons create mengembalikan identitas tugas dan, ketika tersedia, juga dapat menyertakan poll_url yang diprioritaskan.

Body Permintaan

modelstringbawaan: suno_music

ID model musik, misalnya suno-music. Untuk lirik saja, pilih model yang operasi publik terkininya mencakup lyrics.

promptstring

Deskripsi musik atau teks pengganti. Wajib untuk musik, lirik, upload-cover, upload-extend, dan replace-section; opsional untuk add-instrumental dan pemisahan trek.

titlestring

Judul untuk lagu yang dihasilkan.

tagsstring

Tag gaya (misalnya, "pop, upbeat, electronic").

negative_tagsstring

Gaya yang perlu dihindari. Wajib saat audio_operation bernilai add-instrumental.

actionstring

Nilai opsional MUSIC atau LYRICS. Pilih model yang mendukung operasi publik terkait; field ini tidak menambahkan kemampuan lirik pada model khusus musik.

mvstring

Pemilih versi Suno. Wajib untuk pembuatan, upload-cover, upload-extend, add-instrumental, dan penggantian dari audio_url. Hilangkan untuk lirik, penggantian dari task_id + audio_id, dan pemisahan trek. Nilai yang diterima: 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.

make_instrumentalboolean

Setel ke true untuk menghasilkan output instrumental tanpa vokal.

audio_urlstring

URL audio referensi atau unggahan yang dapat diakses publik. Jika dikirim tanpa audio_operation, TokenLab memakai alur upload-cover.

audio_operationstring

Operasi audio: upload-cover, upload-extend, add-instrumental, replace-section, vocal-separate, multi-stem-separation, advanced-split.

vocal-separate, multi-stem-separation, dan advanced-split memerlukan task_id + audio_id; advanced-split juga memerlukan stem_name. upload-extend memerlukan continue_at lebih besar dari 0. add-instrumental memerlukan audio_url, title, tags, dan negative_tags.

replace-section memerlukan prompt, tags, title, infill_start_s, infill_end_s, dan full_lyrics. Pilih tepat satu sumber: task_id + audio_id, atau audio_url + mv. Interval penggantian harus 6–60 detik.

task_idstring

ID tugas sumber milik organisasi Anda, untuk mengganti audio yang dihasilkan atau memisahkan trek.

audio_idstring

ID audio yang dikembalikan dalam hasil tugas sumber. Wajib bersama task_id untuk penggantian audio yang dihasilkan dan pemisahan trek.

infill_start_snumber

Awal penggantian dalam detik, minimal 0. Wajib untuk replace-section.

infill_end_snumber

Akhir penggantian dalam detik. Wajib untuk replace-section, 6–60 detik setelah infill_start_s.

full_lyricsstring

Lirik lengkap lagu hasil. Wajib untuk replace-section.

stem_namestring

Nama trek. Wajib untuk advanced-split.

continue_clip_idstring

ID klip sebelumnya untuk dilanjutkan.

continue_atnumber

Waktu dalam detik untuk melanjutkan. Wajib dan lebih besar dari 0 untuk upload-extend.

prompt menerima hingga 5000 karakter; tags dan negative_tags masing-masing hingga 1000 karakter. Operasi dan parameter yang didukung mengikuti detail model terkini.

Respons

idstring

ID tugas untuk polling status.

task_idstring

Alias dari ID tugas asinkron yang sama, jika dikembalikan.

poll_urlstring

URL polling prioritas ketika tersedia.

statusstring

Status tugas: pending, processing, completed, atau failed.

createdinteger

Timestamp Unix pembuatan tugas, jika dikembalikan.

Permintaan

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"
  }'

Respons

Response
{
  "id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "task_id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "poll_url": "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "status": "pending",
  "model": "suno-music"
}

Otorisasi

BearerAuth
AuthorizationBearer <token>

Autentikasi API Key. Buat atau kelola API key di Dashboard > API > API Keys.

Lokasi: header

Header

X-TokenLab-Delivery-Policy?string

Kebijakan Pengiriman per-permintaan. Menggantikan default API key dan Workspace. Secara otomatis mencoba TokenLab Verified terlebih dahulu dan dapat beralih satu kali ke Official saja sebelum output, penerimaan permintaan, atau pembuatan sumber daya persisten.

Nilai yang tersedia

  • "auto"
  • "verified"
  • "official"

Body permintaan

application/json

Respons

application/json

application/json

Realtime WebSocket

Sebelumnya

Dapatkan Status Musik

Berikutnya