Lấy Trạng thái Tác vụ

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

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

string

bắt buộc

ID tác vụ được trả về từ yêu cầu create.

Phản hồi

string

Định danh tác vụ.

string

Bí danh của mã định danh tác vụ bất đồng bộ.

string

URL polling ưu tiên khi phản hồi tạo tác vụ cung cấp.

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.

boolean

true khi một async task đang chờ được hủy trước khi thực thi.

string

Dấu hiệu hủy. Có giá trị cancelled khi hủy thành công.

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.

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.

string

URL asset kết quả khi tác vụ hoàn tất và tạo ra một video.

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

Cốt lõi

Văn bản

Tệp và lô

Hình ảnh

Âm thanh & thời gian thực

Âm nhạc

Video & tư liệu

Worlds

3D

Tác vụ bất đồng bộ

Gemini gốc

Quản lý

Lấy Trạng thái Tác vụ

Tổng quan

Tham số Đường dẫn

Phản hồi

Hành vi lỗi

Ví dụ

​Tổng quan

​Tham số Đường dẫn

​Phản hồi

​Hành vi lỗi

​Ví dụ

Tổng quan

Tham số Đường dẫn

Phản hồi

Hành vi lỗi

Ví dụ