ตรวจสถานะงานสร้างของ Rivya API ซ้ำด้วยรหัสงานสาธารณะ อ่านสถานะรอคิว กำลังประมวลผล สำเร็จ หรือล้มเหลว แล้วใช้ URL ของผลลัพธ์

ใช้ GET /api/v1/generations/{taskId} เพื่อตรวจงานสร้างแบบอะซิงโครนัส

ปลายทางของ API

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

ส่วนหัวที่จำเป็น:

Authorization: Bearer rvya_sk_...

ตัวอย่าง curl

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

ค่าสถานะ

ค่าสถานะสาธารณะ:

queued: ระบบรับงานแล้ว แต่ยังไม่เสร็จ
processing: กำลังสร้างผลลัพธ์
succeeded: ผลลัพธ์พร้อมใช้งาน
failed: งานล้มเหลวและอาจมีออบเจ็กต์ข้อผิดพลาดสาธารณะ

ผลตอบกลับเมื่อสำเร็จ

{
  "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 คือ URL ผลลัพธ์รายการแรกเพื่อความสะดวก ส่วน output_urls จะมีรายการ URL ผลลัพธ์สาธารณะเมื่อพร้อมใช้งาน

ผลตอบกลับเมื่อเกิดความล้มเหลว

{
  "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."
  }
}

คำแนะนำในการตรวจสถานะซ้ำ

เริ่มด้วยการรอสั้นๆ แล้วค่อยเพิ่มช่วงเวลาตรวจสถานะ หลีกเลี่ยงการวนเรียกถี่

รูปแบบที่แนะนำ:

รอ 2–3 วินาทีหลังส่งงาน
ตรวจสถานะทุก 5–10 วินาทีสำหรับงานทั่วไป
ลดความถี่ลงสำหรับงานวิดีโอและเสียง
หยุดตรวจสถานะเมื่อค่า status เป็น succeeded หรือ failed

ขอบเขตการเป็นเจ้าของ

งานต้องเป็นของบัญชี Rivya เดียวกับคีย์ API หากหาไม่พบหรือไม่ได้เป็นของบัญชีนี้ จุดเชื่อมต่อจะส่งคืน not_found

สถานะงานสร้าง