공개 작업 ID로 Rivya API 생성 상태를 조회하고 queued, processing, succeeded, failed 상태와 결과 URL을 확인하세요.

비동기 생성 작업의 상태를 확인하려면 GET /api/v1/generations/{taskId}를 사용하세요.

엔드포인트

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입니다. 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초마다 상태를 확인합니다.
처리 시간이 긴 동영상과 오디오 작업은 더 긴 간격으로 확인합니다.
상태가 succeeded 또는 failed가 되면 조회를 중지합니다.

소유권 범위

작업은 API 키와 연결된 동일한 Rivya 계정의 소유여야 합니다. 작업을 찾을 수 없거나 해당 계정 소유가 아니면 엔드포인트가 not_found를 반환합니다.

생성 상태