비동기 작업

오래 걸리는 작업은 요청을 제출하고 결과를 나중에 받는 비동기 작업 모델을 씁니다. 게이트웨이에는 두 종류가 있고, 폴링 경로가 서로 다릅니다.

1. Responses background 잡

POST /v1/responses 에 background: true 를 주면 즉시 status: "queued" 로 응답합니다.

{
  "model": "everyais/gemini-3-5-flash-lite",
  "input": "긴 리서치 작업...",
  "background": true
}

• 폴링: GET /v1/responses/{id}
• 상태 전이: queued → in_progress → completed / incomplete / failed / cancelled
• 취소: POST /v1/responses/{id}/cancel (queued·in_progress 만 취소되고 예약 크레딧이 환불됩니다)

2. 비디오 생성 잡

POST /v1/videos/generations 는 항상 비동기입니다. 응답의 id 로 폴링합니다.

• 폴링: GET /v1/videos/generations/{id}
• 진행 중이면 Retry-After: 5 — 5초 간격 폴링을 권장합니다.
• 상태: processing / completed / failed / cancelled

⚠️ 비디오 잡을 GET /v1/outputs/{requestId} 로 조회하면 404 입니다. 비디오 작업 ID와 완료된 요청의 ID는 서로 다릅니다.