TokenLab
API anahtarı al
DokümantasyonAPI ReferansıEntegrasyonlar

Müzik

Müzik Durumunu Al

Bir müzik oluşturma görevinin durumunu ve sonucunu getirir

GET
/v1/tasks/{id}

Müzik oluşturma görevinizin durumunu kontrol etmek için bu endpoint'i sorgulayın.

Create yanıtı poll_url içeriyorsa, sorgulama için doğrudan o URL'yi kullanın. id ve task_id aynı asenkron görev kimliği olarak değerlendirilmelidir.

Süresi dolmuş veya kullanılamayan bir görev 404 async_task_not_found döndürebilir. Geçerli API anahtarının görev sahipliği doğrulanamazsa yanıt 403 task_not_owned olur.

Yol Parametreleri

idstringpathzorunlu

Müzik oluşturma görevi ID'si.

Yanıt

idstring

Görev ID'si.

task_idstring

Aynı asenkron görev ID’sinin takma adı; döndürüldüğünde mevcuttur.

poll_urlstring

Oluşturma yanıtı sağladığında tercih edilen yoklama URL’si.

statusstring

Görev durumu: pending, processing, completed veya failed.

progressinteger

İsteğe bağlı ilerleme değeri. Yalnızca gerçek bir ilerleme değeri varsa döner; tamamlanmayı belirlemek için status kullanın.

Sonuç alanları işleme bağlıdır. Müzik audio_url ve audio_id, yalnızca söz görevleri lyrics, kanal ayırma ise 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. Tamamlanmayı status ile kontrol edin ve gerçekten dönen alanları okuyun.

audio_idstring

Desteklenen sonraki işlemlerde bu görev ID’siyle kullanılabilecek isteğe bağlı ses ID’si.

dataarray

audio_url veya url içeren ayrılmış ses dosyaları gibi isteğe bağlı çıktı dizisi.

audio_urlstring

Ses dosyasını indirmek için URL (tamamlandığında).

video_urlstring

Görselleştirici içeren video sürümünün URL'si (tamamlandığında).

titlestring

Oluşturulan şarkı başlığı.

lyricsstring

Oluşturulan veya sağlanan şarkı sözleri.

errorstring | object

Hata mesajı (başarısız olduğunda).

İstek

curl --fail-with-body "https://api.tokenlab.sh/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" \
  -H "Authorization: Bearer sk-your-api-key"

Yanıt

Response (Completed)
{
  "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"
}

Yetkilendirme

BearerAuth
AuthorizationBearer <token>

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*string

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

Müzik Oluştur

Önceki

Video oluştur

Sonraki