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ộ
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)
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ụ đó.
Định danh tác vụ bất đồng bộ chính tắc.
URL trạng thái cho tác vụ này. Hãy poll GET /v1/tasks/{id} với id.
Dấu thời gian Unix của thời điểm tạo.
Định danh của tác vụ.
Trạng thái tác vụ: pending, processing, completed, hoặc failed.
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àyrevised_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
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.
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.
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.
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 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 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