Musik
Buat Musik
Membuat tugas pembuatan musik, lirik, atau suara
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
suno-musicID model musik, seperti suno-music atau stable-audio-3. Kirimkan secara eksplisit. Untuk lirik saja, pilih model yang operasi publik saat ininya mencakup lyrics.
Deskripsi musik atau teks pengganti. Wajib diisi untuk musik, lirik, upload-cover, upload-extend, dan replace-section; opsional untuk add-instrumental dan pemisahan stem.
Judul untuk lagu yang dihasilkan.
Tag gaya (misalnya, "pop, upbeat, electronic").
Gaya yang harus dihindari. Wajib diisi saat audio_operation bernilai add-instrumental.
Nilai MUSIC atau LYRICS opsional. Pilih model yang mendukung operasi publik yang sesuai; bidang ini tidak menambahkan dukungan lirik ke model khusus musik.
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.
Atur ke true untuk menghasilkan output instrumental tanpa vokal.
URL audio referensi atau audio yang diunggah yang dapat diakses publik. Jika diberikan tanpa audio_operation, TokenLab menggunakan alur upload-cover.
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.
ID tugas sumber milik organisasi Anda, untuk penggantian audio yang dihasilkan atau pemisahan stem.
ID audio sumber yang dikembalikan dalam hasil tugas sumber. Diperlukan bersama task_id untuk penggantian audio yang dihasilkan dan pemisahan stem.
Waktu mulai penggantian dalam detik, minimal 0. Wajib diisi untuk replace-section.
Waktu berakhir penggantian dalam detik. Wajib diisi untuk replace-section; harus berjarak 6–60 detik setelah infill_start_s.
Lirik lengkap untuk lagu yang dihasilkan. Wajib diisi untuk replace-section.
Nama stem. Wajib diisi untuk advanced-split.
ID klip sebelumnya untuk melanjutkan.
Waktu dalam detik untuk memulai kelanjutan. Wajib diisi dan harus lebih besar dari 0 untuk upload-extend.
Durasi audio yang dihasilkan dalam detik, 1 hingga 380. Hanya untuk model yang mencantumkannya, seperti stable-audio-3; detail model memberikan batasannya sendiri.
Format file audio yang dicantumkan oleh model, contohnya mp3, wav, atau flac. Hanya untuk model yang mencantumkannya.
Seed untuk output yang dapat diulang, 0 hingga 4294967294. Hanya untuk model yang mencantumkannya.
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.
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
ID tugas untuk polling status.
Alias dari ID tugas asinkron yang sama, jika dikembalikan.
URL status untuk tugas ini. Lakukan polling GET /v1/tasks/{id} dengan id.
Status tugas: pending, processing, completed, atau failed.
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
{
"id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"task_id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"poll_url": "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"status": "pending",
"model": "suno-music"
}Otorisasi
BearerAuth Autentikasi API Key. Buat atau kelola API key di Dashboard > API > API Keys.
Lokasi: header
Header
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"
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.
1 <= length <= 255Body permintaan
application/json
Respons
application/json
application/json
application/json
application/json
application/json
application/json