Tác vụ

Trạng thái tác vụ

Trạng thái	Ý nghĩa	Bước tiếp theo
`processing`	Tác vụ đã được tiếp nhận và chưa hoàn tất.	Tiếp tục truy vấn.
`completed`	Tác vụ đã thành công.	Đọc `output.data[].url`.
`failed`	Tác vụ không hoàn tất thành công.	Kiểm tra `error`; tác vụ này không bị tính phí.

Phản hồi khi gửi

Khi gửi, API trả về một tham chiếu tác vụ:

{
  "id": "task_...",
  "model": "gpt-image-2",
  "status": "processing",
  "created_at": 1789970508
}

Truy vấn tác vụ

curl https://api.seedrouter.ai/v1/tasks/YOUR_TASK_ID \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY"

Hãy truy vấn với nhịp vừa phải, chẳng hạn ba giây một lần, cho đến khi status là completed hoặc failed. Hết thời gian mạng trong lúc truy vấn không có nghĩa là việc tạo ảnh đã thất bại: hãy giữ ID tác vụ và tiếp tục kiểm tra. Đừng tạo tác vụ khác chỉ để xem tiến độ.

Ví dụ truy vấn đầy đủ

Hãy chạy đoạn này sau ví dụ gửi bằng Python trong Bắt đầu nhanh. Nó dùng task_id được trả về và chờ tối đa mười phút. Chạm tới mốc thời gian cục bộ này chỉ dừng việc truy vấn; hãy giữ ID và tiếp tục truy vấn đúng tác vụ đó.

import time

print(f"Task ID: {task_id}")
deadline = time.monotonic() + 600
while time.monotonic() < deadline:
    result = requests.get(
        f"https://api.seedrouter.ai/v1/tasks/{task_id}",
        headers={"Authorization": f"Bearer {os.environ['SEEDROUTER_API_KEY']}"},
        timeout=30,
    )
    result.raise_for_status()
    task = result.json()
    if task["status"] == "completed":
        for image in task["output"]["data"]:
            print(image["url"])
        break
    if task["status"] == "failed":
        raise RuntimeError(task["error"]["message"])
    time.sleep(3)
else:
    raise TimeoutError(f"Still waiting. Resume polling task {task_id}.")

Tác vụ đã hoàn tất

Tác vụ đã hoàn tất trả về URL ảnh được lưu trữ cùng thông tin mức sử dụng:

{
  "id": "task_...",
  "model": "gpt-image-2",
  "status": "completed",
  "created_at": 1789970508,
  "finished_at": 1789970538,
  "output": {
    "created": 1789970532,
    "data": [{"url": "https://static.seedrouter.ai/media/tasks/task_example/0.png"}],
    "usage": {
      "input_tokens": 29,
      "output_tokens": 196,
      "total_tokens": 225
    }
  }
}

Trường	Ý nghĩa
`id`	Hãy giữ ID này cho các lần truy vấn sau.
`status`	`processing`, `completed` hoặc `failed`.
`created_at`, `finished_at`	Dấu thời gian Unix tính bằng giây; trong lúc xử lý, thời điểm hoàn tất để trống hoặc bằng 0.
`output.data[].url`	URL của ảnh đã tạo, có sẵn khi tác vụ hoàn tất.
`output.usage`	Mức sử dụng token được báo cáo, khi có. Các đối tượng chi tiết có thể chứa số token văn bản và ảnh.
`error`	Lỗi có cấu trúc của một tác vụ thất bại.

API này trả kết quả theo cơ chế tác vụ bất đồng bộ. Đây không phải bản thay thế cho SDK Images đồng bộ; stream và partial_images không được hỗ trợ.

Trạng thái tác vụ

Phản hồi khi gửi

Truy vấn tác vụ

Ví dụ truy vấn đầy đủ

Tác vụ đã hoàn tất

On this page