Müzik
Müzik Durumunu Al
Bir müzik oluşturma görevinin durumunu ve sonucunu alır
GET /v1/music/generations/{id} bir uyumluluk uç noktasıdır. Mevcut entegrasyonlar için desteklenmeye devam etmektedir. Yeni entegrasyonlar GET /v1/tasks/{id} uç noktasını sorgulamalıdır; bkz. Görev Durumunu Al.
Müzik oluşturma görevinizin durumunu kontrol etmek için GET /v1/tasks/{id} çağrısı yapın.
id ve task_id aynı görevi tanımlar.
Süresi dolmuş veya kullanılamayan bir genel görev 404 async_task_not_found döndürebilir. Mevcut API anahtarı için görev sahipliği doğrulanamazsa, yanıt 403 task_not_owned olur.
Yol Parametreleri
Müzik oluşturma görevi kimliği (ID).
Yanıt
Görev kimliği (ID).
Döndürüldüğünde, aynı eşzamansız görev kimliğinin takma adı.
Bu görev için durum URL'si. id ile GET /v1/tasks/{id} sorgusu yapın.
Görev durumu: pending, processing, completed, failed veya timeout. Başarısız bir görev yine de HTTP 200 döndürür.
İsteğe bağlı ilerleme değeri. Yalnızca gerçek bir ilerleme değeri mevcut olduğunda döndürülür; tamamlanma durumunu belirlemek için status alanını kullanın.
Sonuç alanları işleme göre değişir. Müzik; audio_url ve audio_id döndürebilir; yalnızca söz içeren görevler lyrics döndürür; ayırma işlemi data içinde birden fazla dosya döndürebilir. video_url, başlık, ilerleme ve diğer meta veriler isteğe bağlıdır. Tamamlanma için status alanını kontrol edin ve fiilen döndürülen alanları okuyun.
Desteklenen takip işlemlerinde bu görevin kimliğiyle birlikte kullanılabilen isteğe bağlı kaynak ses kimliği.
audio_url veya url içeren ayrılmış ses dosyaları dahil olmak üzere isteğe bağlı çıktı dizisi.
Ses dosyasını indirmek için URL (tamamlandığında). 30 gün boyunca geçerli kalan bir TokenLab medya sonucu bağlantısıdır.
Görselleştirici içeren video sürümünün URL'si (tamamlandığında ve model için döndürüldüğünde).
Model bir tane döndürdüğünde kapak resmi URL'si.
Oluşturulan şarkı başlığı.
Oluşturulan veya sağlanan şarkı sözleri.
Hata mesajı (başarısız olduğunda).
Görev başarısız olduğunda hata ayrıntıları: status, message, type, code, retryable ve bir istek alanı hatalı olduğunda param.
Sonuç bağlantılarının saklama durumu: days ve url, kind, status ve expires_at içeren items[]. Bu alan bulunmayabilir; bağlantılar yine de çalışır. Bkz. Veri saklama.
İstek
curl --fail-with-body "https://api.tokenlab.sh/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" \
-H "Authorization: Bearer sk-your-api-key"Yanıt
{
"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"
}
]
}
}Yetkilendirme
BearerAuth API Anahtarı kimlik doğrulaması. API anahtarlarını Dashboard > API > API Keys bölümünden oluşturun veya yönetin.
Konum: header
Yol parametreleri
id / task_id tarafından döndürülen veya poll_url içine gömülü olan asenkron görev kimliği
Yanıt
application/json
application/json
application/json
application/json
application/json
application/json
application/json