Musik

Buat Musik

Membuat tugas pembuatan musik, lirik, atau suara

POST
/v1/music/generations

Gunakan GET /v1/models?recommended_for=music untuk mendapatkan model musik saat ini.

Hasilkan musik, lirik, dan suara dengan AI. Ini adalah API asinkron. Respons pembuatan mengembalikan identitas tugas. Lakukan polling GET /v1/tasks/{id} dengannya untuk memeriksa status.

Setiap model menerima bidang yang berbeda-beda. Periksa GET /v1/models/{model} sebelum mengirim bidang opsional; bidang yang tidak tercantum dalam model dapat mengembalikan 400 unsupported_parameter. Bidang Suno (mv, title, tags, negative_tags, audio_operation, dan bidang terkait lainnya) berlaku untuk model Suno. user tidak didukung dan mengembalikan 400.

Body Permintaan

modelstringbawaan: suno-music

ID model musik, seperti suno-music atau stable-audio-3. Kirimkan secara eksplisit. Untuk lirik saja, pilih model yang operasi publik saat ininya mencakup lyrics.

promptstring

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

titlestring

Judul untuk lagu yang dihasilkan.

tagsstring

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

negative_tagsstring

Gaya yang harus dihindari. Wajib diisi saat audio_operation bernilai add-instrumental.

actionstring

Nilai MUSIC atau LYRICS opsional. Pilih model yang mendukung operasi publik yang sesuai; bidang ini tidak menambahkan dukungan lirik ke model khusus musik.

mvstring

Pemilih versi Suno. Wajib diisi untuk pembuatan, upload-cover, upload-extend, add-instrumental, dan penggantian dari audio_url. Abaikan untuk lirik, penggantian dari task_id + audio_id, dan pemisahan stem. Nilai yang diterima: chirp-v6, chirp-v6-mini, chirp-v6-wild.

make_instrumentalboolean

Atur ke true untuk menghasilkan output instrumental tanpa vokal.

audio_urlstring

URL audio referensi atau audio yang diunggah yang dapat diakses publik. Jika diberikan tanpa audio_operation, TokenLab menggunakan 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.

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

task_idstring

ID tugas sumber milik organisasi Anda, untuk penggantian audio yang dihasilkan atau pemisahan stem.

audio_idstring

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

infill_start_snumber

Waktu mulai penggantian dalam detik, minimal 0. Wajib diisi untuk replace-section.

infill_end_snumber

Waktu berakhir penggantian dalam detik. Wajib diisi untuk replace-section; harus berjarak 6–60 detik setelah infill_start_s.

full_lyricsstring

Lirik lengkap untuk lagu yang dihasilkan. Wajib diisi untuk replace-section.

stem_namestring

Nama stem. Wajib diisi untuk advanced-split.

continue_clip_idstring

ID klip sebelumnya untuk melanjutkan.

continue_atnumber

Waktu dalam detik untuk memulai kelanjutan. Wajib diisi dan harus lebih besar dari 0 untuk upload-extend.

durationinteger

Durasi audio yang dihasilkan dalam detik, 1 hingga 380. Hanya untuk model yang mencantumkannya, seperti stable-audio-3; detail model memberikan batasannya sendiri.

output_formatstring

Format file audio yang dicantumkan oleh model, contohnya mp3, wav, atau flac. Hanya untuk model yang mencantumkannya.

seedinteger

Seed untuk output yang dapat diulang, 0 hingga 4294967294. Hanya untuk model yang mencantumkannya.

stepsinteger

Jumlah langkah generasi. Rentang bergantung pada model (sebagai contoh 4 hingga 8 untuk stable-audio-3). Hanya untuk model yang mencantumkannya.

Beberapa model mencantumkan lebih banyak field, seperti negative_prompt, n, seconds, dan guidance_scale. Kirimkan field tersebut hanya jika detail model mencantumkannya; field yang tidak didukung oleh model yang dipilih akan mengembalikan 400.

cfg_scalenumber

Kekuatan panduan prompt, 1 hingga 25. Hanya untuk model yang mencantumkannya.

prompt menerima hingga 5000 karakter; tags dan negative_tags masing-masing menerima hingga 1000 karakter. Operasi dan parameter yang didukung bergantung pada detail model yang dipilih saat ini.

Respons

idstring

ID tugas untuk polling status.

task_idstring

Alias dari ID tugas asinkron yang sama, jika dikembalikan.

poll_urlstring

URL status untuk tugas ini. Lakukan polling GET /v1/tasks/{id} dengan id.

statusstring

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

createdinteger

Waktu pembuatan tugas sebagai Unix timestamp, 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-v6",
    "prompt": "An upbeat electronic dance track with heavy bass",
    "title": "Night Drive",
    "tags": "electronic, EDM, energetic"
  }'

Contoh pembuatan suara untuk model yang menerima duration dan output_format alih-alih bidang Suno:

{
  "model": "stable-audio-3",
  "prompt": "Warm lo-fi beat with soft vinyl crackle",
  "duration": 30,
  "output_format": "mp3"
}

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"
Idempotency-Key?string

Kunci opsional yang membuat permintaan pembuatan aman untuk dicoba ulang. Kirim nilai unik baru, seperti UUID, untuk setiap tugas. Percobaan ulang dengan kunci dan body yang sama akan mengembalikan hasil dari permintaan pembuatan asli, biasanya berupa tugas asli, dan tidak akan membuat, mengirim, atau mengenakan biaya untuk tugas kedua. Body yang berbeda dengan kunci yang sudah diterima akan ditolak dengan 409. Kunci yang lebih panjang dari 255 karakter akan diabaikan, dan permintaan tersebut tidak akan memiliki perlindungan idempotensi. Lihat Retry safely with an idempotency key.

Panjang1 <= length <= 255

Body permintaan

application/json

Respons

application/json

application/json

application/json

application/json

application/json

application/json