TokenLab

Hình ảnh

Lấy trạng thái hình ảnh

Lấy trạng thái và kết quả của một tác vụ tạo hình ảnh bất đồng bộ

GET
/v1/tasks/{id}

Các đường dẫn dành riêng cho hình ảnh /v1/images/generations/{id} và /v1/images/{id} là các endpoint tương thích. Chúng vẫn được hỗ trợ cho các tích hợp hiện có. Các tích hợp mới nên thực hiện poll GET /v1/tasks/{id}; xem Lấy trạng thái tác vụ.

Tham số đường dẫn (Path Parameters)

idstringpathbắt buộc

ID tác vụ được trả về từ yêu cầu tạo hình ảnh ban đầu.

Sử dụng id hoặc task_id từ phản hồi tạo tác vụ.

Bí danh tương thích /v1/images/{id} chấp nhận các ID tác vụ hình ảnh công khai như ldtask_.... Nó sử dụng cùng cơ chế xác thực, kiểm tra quyền sở hữu, tiêu đề thanh toán, ảnh chụp nhanh terminal và cấu trúc phản hồi như /v1/images/generations/{id}.

Một tác vụ công khai đã hết hạn hoặc không khả dụng có thể trả về 404 async_task_not_found. Nếu không thể xác định quyền sở hữu tác vụ cho API key hiện tại, phản hồi sẽ là 403 task_not_owned.

Phản hồi (Response)

Các trường mô tả kết quả, lỗi, dấu thời gian (timestamp) và mô hình sẽ được trả về khi có sẵn cho tác vụ đó.

idstring

Định danh tác vụ bất đồng bộ chính tắc.

poll_urlstring

URL trạng thái cho tác vụ này. Hãy poll GET /v1/tasks/{id} với id.

createdinteger

Dấu thời gian Unix của thời điểm tạo.

task_idstring

Định danh của tác vụ.

statusstring

Trạng thái tác vụ: pending, processing, completed, hoặc failed.

dataarray

Mảng các hình ảnh đã tạo (được điền khi status là completed).

Mỗi đối tượng chứa:

  • url (string): URL kết quả phương tiện của TokenLab cho hình ảnh đã tạo, có hiệu lực trong 30 ngày
  • revised_prompt (string): Bản sửa đổi prompt tùy chọn, khi mô hình được chọn trả về một bản sửa đổi
errorstring | object

Lý do tác vụ thất bại (chỉ khi status là failed): một chuỗi, hoặc một đối tượng với message và, khi biết, bao gồm type, code, param, và retryable.

error_detailsobject

Chi tiết lỗi khi tác vụ thất bại: status, message, type, code, retryable, và param khi một trường trong yêu cầu gặp lỗi.

media_retentionobject

Trạng thái lưu trữ của các liên kết hình ảnh: days và items[] với url, kind, status, và expires_at. Trường này có thể không xuất hiện; các liên kết vẫn hoạt động bình thường. Xem Lưu giữ dữ liệu.

usageobject

Số lượng token cho các mô hình tính phí theo token như gpt-image-2, khi có sẵn.

Yêu cầu

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

Phản hồi

{
  "created": 1706000000,
  "id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "task_id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "poll_url": "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "status": "pending",
  "data": []
}

Khoảng thời gian kiểm tra (Check Interval)

Hãy kiểm tra mỗi 3–5 giây khi trạng thái là pending hoặc processing, và dừng lại khi trạng thái là completed hoặc failed.

import requests
import time

def poll_image_task(task_id, api_key, max_wait=300, interval=3):
    """Poll for image generation result with timeout."""
    url = f"https://api.tokenlab.sh/v1/tasks/{task_id}"
    headers = {"Authorization": f"Bearer {api_key}"}

    start_time = time.time()
    while time.time() - start_time < max_wait:
        response = requests.get(url, headers=headers, timeout=30)
        response.raise_for_status()
        data = response.json()

        if data["status"] == "completed":
            return data["data"][0]["url"]
        elif data["status"] == "failed":
            raise Exception(data.get("error", "Generation failed"))

        time.sleep(interval)

    raise TimeoutError(f"Task {task_id} did not complete within {max_wait}s")

# Usage
image_url = poll_image_task("ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "sk-your-api-key")
print(f"Generated image: {image_url}")

Xác thực

BearerAuth
AuthorizationBearer <token>

Xác thực bằng Khóa API. Tạo hoặc quản lý khóa API trong Dashboard > API > API Keys.

Vị trí: header

Tham số đường dẫn

id*string

ID tác vụ async được trả về bởi id / task_id, hoặc được nhúng trong poll_url

Phản hồi

application/json

application/json

application/json

application/json

application/json

application/json

application/json