public task ID로 Rivya API generation jobs를 polling하고 queued, processing, succeeded, failed 상태와 result URLs를 읽으세요.

비동기 generation job을 확인하려면 GET /api/v1/generations/{taskId}를 사용하세요.

Endpoint

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

Required header:

Authorization: Bearer rvya_sk_...

curl Example

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

Status Values

Public status values:

queued: task가 수락되었지만 아직 완료되지 않음
processing: generation이 실행 중
succeeded: result를 사용할 수 있음
failed: task가 실패했으며 public error object를 포함할 수 있음

Succeeded Response

{
  "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은 편의를 위한 첫 번째 result URL입니다. urls는 사용 가능한 경우 public result URL list를 포함합니다.

Failed Response

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

Polling Guidance

짧게 기다린 뒤 polling 간격을 늘리세요. 좁은 loop는 피하세요.

Recommended pattern:

submission 후 2-3초 기다립니다.
일반 jobs는 5-10초마다 poll합니다.
긴 video 및 audio jobs는 더 천천히 poll합니다.
status가 succeeded 또는 failed가 되면 polling을 중지합니다.

Ownership Boundary

task는 API key 뒤의 같은 Rivya account에 속해야 합니다. 찾을 수 없거나 account 소유가 아니면 endpoint는 not_found를 반환합니다.

Generation Status