Ana içeriğe atla

​
Genel Bakış

Video, görsel, müzik ve 3D üretimi gibi görev türleri arasında birleşik async polling için bu endpoint’i kullanın. Bir create yanıtı poll_url içeriyorsa, tam olarak o path’i çağırın. Daha yeni async workflow’lar için poll_url, /v1/tasks/{id} adresini işaret edebilir.

​
Path Parametreleri

​
id
string
gerekli
Create isteğinden döndürülen görev kimliği.

​
Yanıt

​
id
string
Görev tanımlayıcısı.
​
task_id
string
Asenkron görev kimliği takma adı.
​
poll_url
string
Oluşturma yanıtı sağladığında tercih edilen yoklama URL’si.
​
status
string
Görev durumu: pending, processing, completed veya failed. İptal edilen görevler failed ve cancelled: true olarak temsil edilir.
​
cancelled
boolean
Kuyruktaki bir asenkron görev yürütülmeden önce iptal edildiyse true.
​
cancellation_status
string
İptal işareti. İptal başarılı olduğunda cancelled olarak bulunur.
​
data
array
Tamamlanan görüntü görevleri için oluşturulan görüntü sonuçları burada döndürülür. Görüntü görevleri URL’leri data[].url içinde döndürür.
​
progress
number
İ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.
​
video_url
string
Görev tamamlandığında ve bir video ürettiğinde sonuç varlığının URL’si.
​
error
string
Görev başarısız olduğunda hata mesajı.

​
Hata Davranışı

Görev artık mevcut değilse, süresi dolmuşsa veya genel görev kaydında artık bulunmuyorsa TokenLab şunu döndürür: 
{
  "error": {
    "message": "Task not found or no longer available.",
    "type": "invalid_request_error",
    "code": "async_task_not_found"
  }
}

​
Örnekler

curl "https://api.tokenlab.sh/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" \
  -H "Authorization: Bearer sk-your-api-key"
Python
import requests

poll_url = "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
response = requests.get(
    f"https://api.tokenlab.sh{poll_url}",
    headers={"Authorization": "Bearer sk-your-api-key"},
)
print(response.json())
JavaScript
const pollUrl = '/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa';
const response = await fetch(`https://api.tokenlab.sh${pollUrl}`, {
  headers: { Authorization: 'Bearer sk-your-api-key' },
});
console.log(await response.json());