Trạng thái tạo nội dung

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.

Trang liên quan

• Tạo generation

• API Credits

• Vòng đời tác vụ trong Rivya

• Tác vụ thất bại và hoàn credits