Müzik

Müzik Durumunu Al

Bir müzik oluşturma görevinin durumunu ve sonucunu alır

GET
/v1/tasks/{id}

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

idstringpathzorunlu

Müzik oluşturma görevi kimliği (ID).

Yanıt

idstring

Görev kimliği (ID).

task_idstring

Döndürüldüğünde, aynı eşzamansız görev kimliğinin takma adı.

poll_urlstring

Bu görev için durum URL'si. id ile GET /v1/tasks/{id} sorgusu yapın.

statusstring

Görev durumu: pending, processing, completed, failed veya timeout. Başarısız bir görev yine de HTTP 200 döndürür.

progressinteger

İ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.

audio_idstring

Desteklenen takip işlemlerinde bu görevin kimliğiyle birlikte kullanılabilen isteğe bağlı kaynak ses kimliği.

dataarray

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

audio_urlstring

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.

video_urlstring

Görselleştirici içeren video sürümünün URL'si (tamamlandığında ve model için döndürüldüğünde).

image_urlstring

Model bir tane döndürdüğünde kapak resmi URL'si.

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).

error_detailsobject

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.

media_retentionobject

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

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

application/json

application/json

application/json