Langsung ke konten utama

​
Gambaran Umum

Gunakan endpoint ini untuk polling async terpadu di berbagai jenis task seperti pembuatan video, gambar, musik, dan 3D. Jika respons create menyertakan poll_url, panggil path tersebut secara persis. Untuk alur kerja async yang lebih baru, poll_url dapat mengarah ke /v1/tasks/{id}.

​
Parameter Path

​
id
string
wajib
ID task yang dikembalikan oleh permintaan create.

​
Respons

​
id
string
Pengidentifikasi task.
​
task_id
string
Alias pengenal tugas asinkron.
​
poll_url
string
URL polling yang diutamakan saat respons pembuatan menyediakannya.
​
status
string
Status task seperti pending, processing, completed, atau failed. Task yang dibatalkan direpresentasikan sebagai failed dengan cancelled: true.
​
cancelled
boolean
true ketika async task yang masih antre dibatalkan sebelum eksekusi.
​
cancellation_status
string
Penanda pembatalan. Ada sebagai cancelled ketika pembatalan berhasil.
​
data
array
Untuk task gambar yang selesai, hasil gambar yang dibuat dikembalikan di sini. Task gambar mengembalikan URL di data[].url.
​
progress
number
Nilai progres opsional. Hanya dikembalikan saat nilai progres nyata tersedia; gunakan status untuk menentukan penyelesaian.
​
video_url
string
URL aset hasil ketika task selesai dan menghasilkan video.
​
error
string
Pesan error ketika task gagal.

​
Perilaku Error

Jika tugas sudah tidak ada, telah kedaluwarsa, atau tidak lagi tersedia di catatan tugas publik, TokenLab mengembalikan: 
{
  "error": {
    "message": "Task not found or no longer available.",
    "type": "invalid_request_error",
    "code": "async_task_not_found"
  }
}

​
Contoh

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());