Musik
Dapatkan Status Musik
Mengambil status dan hasil dari tugas pembuatan musik
Lakukan polling pada endpoint ini untuk memeriksa status tugas pembuatan musik Anda.
Jika respons create menyertakan poll_url, prioritaskan URL tersebut saat melakukan polling. id dan task_id harus diperlakukan sebagai identitas tugas asinkron yang sama.
Task publik yang kedaluwarsa atau tidak tersedia dapat mengembalikan 404 async_task_not_found. Jika kepemilikan task untuk API key saat ini tidak dapat dipastikan, responsnya adalah 403 task_not_owned.
Parameter Path
ID tugas pembuatan musik.
Respons
ID tugas.
Alias dari ID tugas asinkron yang sama, jika dikembalikan.
URL polling yang diutamakan saat disediakan oleh respons pembuatan.
Status tugas: pending, processing, completed, atau failed.
Nilai progres opsional. Hanya dikembalikan saat nilai progres nyata tersedia; gunakan status untuk menentukan penyelesaian.
Field hasil bergantung pada operasi. Musik dapat mengembalikan audio_url dan audio_id; tugas lirik saja mengembalikan lyrics; pemisahan dapat mengembalikan beberapa file dalam data. video_url, judul, progres, dan metadata lain bersifat opsional. Periksa penyelesaian melalui status dan baca field yang benar-benar dikembalikan.
ID audio opsional untuk digunakan dengan ID tugas ini dalam operasi lanjutan yang didukung.
Array keluaran opsional, termasuk file trek terpisah dengan audio_url atau url.
URL untuk mengunduh file audio (saat selesai).
URL ke versi video dengan visualizer (saat selesai).
Judul lagu yang dihasilkan.
Lirik yang dihasilkan atau disediakan.
Pesan kesalahan (saat gagal).
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://cdn.example.com/music/abc123.mp3",
"title": "Night Drive",
"lyrics": "[Verse 1]\nDriving through the night...",
"audio_id": "audio_abc123"
}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