Poll job generation của Rivya API theo public task ID, đọc các trạng thái queued, processing, succeeded và failed, rồi sử dụng URL kết quả.

Dùng GET /api/v1/generations/{taskId} để kiểm tra một job generation bất đồng bộ.

Endpoint

GET https://rivya.ai/api/v1/generations/{taskId}

Header bắt buộc:

Authorization: Bearer rvya_sk_...

Ví dụ curl

curl https://rivya.ai/api/v1/generations/task_public_id \
  -H "Authorization: Bearer rvya_sk_..."

Giá trị trạng thái

Các giá trị trạng thái công khai:

queued: tác vụ đã được chấp nhận, chưa hoàn tất
processing: generation đang chạy
succeeded: kết quả đã khả dụng
failed: tác vụ thất bại và có thể bao gồm object lỗi công khai

Phản hồi thành công

{
  "id": "task_public_id",
  "status": "succeeded",
  "model": "z-image",
  "reserved_credits": 1,
  "final_credits": 1,
  "created_at": "2026-05-10T00:00:00.000Z",
  "updated_at": "2026-05-10T00:01:00.000Z",
  "result": {
    "primary_url": "https://media.example/result.png",
    "urls": ["https://media.example/result.png"]
  },
  "error": null
}

primary_url là URL kết quả đầu tiên để tiện dùng. urls chứa danh sách URL kết quả công khai khi có.

Phản hồi thất bại

{
  "id": "task_public_id",
  "status": "failed",
  "model": "z-image",
  "reserved_credits": 1,
  "final_credits": 0,
  "created_at": "2026-05-10T00:00:00.000Z",
  "updated_at": "2026-05-10T00:01:00.000Z",
  "result": null,
  "error": {
    "code": "generation_failed",
    "message": "The generation failed."
  }
}

Hướng dẫn polling

Bắt đầu bằng một khoảng chờ ngắn, sau đó tăng dần khoảng cách polling. Tránh vòng lặp dày đặc.

Mẫu khuyến nghị:

chờ 2-3 giây sau khi gửi
poll mỗi 5-10 giây với job thông thường
chậm hơn với job video và âm thanh dài
dừng polling khi trạng thái là succeeded hoặc failed

Ranh giới sở hữu

Tác vụ phải thuộc cùng tài khoản Rivya đứng sau API key. Nếu không tìm thấy hoặc không thuộc tài khoản, endpoint trả về not_found.

Trạng thái generation