Chuyển đến nội dung chính

​
Tổng quan

Sử dụng endpoint này để polling async hợp nhất trên nhiều loại tác vụ như tạo video, hình ảnh, âm nhạc và 3D. Nếu phản hồi create bao gồm poll_url, hãy gọi chính xác path đó. Đối với các workflow async mới hơn, poll_url có thể trỏ tới /v1/tasks/{id}.

​
Tham số Đường dẫn

​
id
string
bắt buộc
ID tác vụ được trả về từ yêu cầu create.

​
Phản hồi

​
id
string
Định danh tác vụ.
​
task_id
string
Bí danh của mã định danh tác vụ bất đồng bộ.
​
poll_url
string
URL polling ưu tiên khi phản hồi tạo tác vụ cung cấp.
​
status
string
Trạng thái tác vụ như pending, processing, completed hoặc failed. Tác vụ đã hủy được biểu diễn là failed với cancelled: true.
​
cancelled
boolean
true khi một async task đang chờ được hủy trước khi thực thi.
​
cancellation_status
string
Dấu hiệu hủy. Có giá trị cancelled khi hủy thành công.
​
data
array
Với tác vụ hình ảnh đã hoàn tất, kết quả hình ảnh được tạo sẽ được trả về tại đây. Tác vụ hình ảnh trả về URL trong data[].url.
​
progress
number
Giá trị tiến độ tùy chọn. Chỉ được trả về khi có giá trị tiến độ thực; hãy dùng status để xác định khi tác vụ hoàn tất.
​
video_url
string
URL asset kết quả khi tác vụ hoàn tất và tạo ra một video.
​
error
string
Thông báo lỗi khi tác vụ thất bại.

​
Hành vi lỗi

Nếu tác vụ không còn tồn tại, đã hết hạn hoặc không còn có trong bản ghi tác vụ công khai, TokenLab trả về: 
{
  "error": {
    "message": "Task not found or no longer available.",
    "type": "invalid_request_error",
    "code": "async_task_not_found"
  }
}

​
Ví dụ

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