Musik
Mendapatkan Status Musik
Mengambil status dan hasil dari tugas pembuatan musik
GET /v1/music/generations/{id} adalah endpoint kompatibilitas. Endpoint ini tetap didukung untuk integrasi yang sudah ada. Integrasi baru harus melakukan polling ke GET /v1/tasks/{id}; lihat Mendapatkan Status Tugas.
Panggil GET /v1/tasks/{id} untuk memeriksa status tugas pembuatan musik Anda.
id dan task_id mengidentifikasi tugas yang sama.
Tugas publik yang kedaluwarsa atau tidak tersedia dapat mengembalikan 404 async_task_not_found. Jika kepemilikan tugas tidak dapat dipastikan untuk API key saat ini, responsnya adalah 403 task_not_owned.
Parameter Path
ID tugas pembuatan musik.
Respons
ID Tugas.
Alias dari ID tugas asinkron yang sama, saat dikembalikan.
URL status untuk tugas ini. Lakukan polling GET /v1/tasks/{id} dengan id.
Status tugas: pending, processing, completed, failed, atau timeout. Tugas yang gagal tetap mengembalikan HTTP 200.
Nilai progres opsional. Hanya dikembalikan jika nilai progres yang sebenarnya tersedia; gunakan status untuk menentukan penyelesaian.
Bidang hasil bergantung pada operasi. Musik dapat mengembalikan audio_url dan audio_id; tugas khusus lirik mengembalikan lyrics; pemisahan (separation) dapat mengembalikan beberapa file dalam data. video_url, judul, progres, dan metadata lainnya bersifat opsional. Periksa status untuk penyelesaian dan baca bidang yang benar-benar dikembalikan.
ID audio sumber opsional, dapat digunakan dengan ID tugas ini dalam operasi tindak lanjut yang didukung.
Array output opsional, termasuk file audio yang dipisahkan dengan audio_url atau url.
URL untuk mengunduh file audio (saat selesai). Tautan hasil media TokenLab yang tetap valid selama 30 hari.
URL ke versi video dengan visualisator (saat selesai dan dikembalikan untuk model tersebut).
URL gambar sampul, saat model mengembalikannya.
Judul lagu yang dihasilkan.
Lirik yang dihasilkan atau disediakan.
Pesan kesalahan (saat gagal).
Detail kegagalan saat tugas gagal: status, message, type, code, retryable, dan param jika bidang permintaan yang bermasalah.
Status penyimpanan tautan hasil: days dan items[] dengan url, kind, status, dan expires_at. Bidang ini bisa tidak ada; tautan tetap berfungsi. Lihat Retensi data.
Permintaan
curl --fail-with-body "https://api.tokenlab.sh/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" \
-H "Authorization: Bearer sk-your-api-key"Respons
{
"id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"task_id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"poll_url": "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"status": "completed",
"audio_url": "https://api.tokenlab.sh/v1/media-results/2d7e9a41-8c3b-4b6f-a1e5-7f0c3d9b8e26.mp3?token=…",
"title": "Night Drive",
"lyrics": "[Verse 1]\nDriving through the night...",
"audio_id": "audio_abc123",
"media_retention": {
"days": 30,
"items": [
{
"url": "https://api.tokenlab.sh/v1/media-results/2d7e9a41-8c3b-4b6f-a1e5-7f0c3d9b8e26.mp3?token=…",
"kind": "audio",
"content_type": "audio/mpeg",
"status": "saved",
"expires_at": "2024-02-22T08:54:20.000Z"
}
]
}
}Otorisasi
BearerAuth Autentikasi API Key. Buat atau kelola API key di Dashboard > API > API Keys.
Lokasi: header
Parameter path
ID tugas asinkron yang dikembalikan oleh id / task_id, atau disematkan dalam poll_url
Respons
application/json
application/json
application/json
application/json
application/json
application/json
application/json