Rivya 작업 수명 주기 가이드

Rivya에서 이미지, 비디오 또는 오디오 생성 작업을 제출한 뒤 어떤 일이 일어나는지 이해해야 할 때 이 가이드를 사용하세요.

이 문서는 작업 상태, 크레딧 예약, provider 완료, 기록, 알림, 실패한 작업 처리 방식을 한곳에서 설명합니다.

실제 작업 상태

현재 비동기 생성 수명 주기는 네 가지 표시 상태를 사용합니다.

• WAITING
• GENERATING
• SUCCESS
• FAILED

이 상태들은 ai_task에 저장되며 Studio, 기록, 대시보드, 알림 흐름 전반에서 재사용됩니다.

제출하면 어떤 일이 일어나는가

1. Rivya가 요청을 검증합니다

provider에 요청이 도달하기 전에 Rivya는 다음을 확인합니다.

• 모델이 존재하는지
• 해당 모델에서 직접 생성이 활성화되어 있는지
• 런타임이 비동기 작업 기반인지
• prompt 길이가 유효한지
• form parameter가 정규화되었는지
• reference file이 모델이 허용하는 형식과 일치하는지

일부 모델에는 추가 규칙이 있습니다. 예를 들어 audio isolation은 업로드된 오디오 파일과 duration 검증이 모두 필요합니다.

2. Rivya가 작업 기록을 생성합니다

Rivya는 먼저 ai_task 항목을 생성하며, 초기 상태는 WAITING입니다.

이 기록에는 모델, category, prompt, params, 예약된 크레딧, billing type, 그리고 이후 결과 또는 실패 상태가 저장됩니다.

3. Provider 제출 전에 크레딧이 소비됩니다

중요한 점은 비동기 생성의 경우 Rivya가 작업을 upstream으로 보내기 전에 작업 크레딧을 먼저 사용한다는 것입니다.

크레딧이 부족하면 다음과 같이 처리됩니다.

• 작업이 failed로 표시됩니다
• upstream service가 호출되지 않습니다
• 크레딧 부족 알림이 생성될 수 있습니다

4. Provider 작업이 생성됩니다

크레딧이 충분하면 Rivya는 작업을 해당 upstream service로 제출하고 upstream task ID를 저장합니다.

그 시점에 상태는 GENERATING으로 이동합니다.

Rivya가 결과를 확인하는 방식

Rivya는 두 가지 완료 경로를 지원합니다.

• callback을 지원하는 환경에서는 provider callback
• callback 완료를 사용할 수 없을 때는 상태 refresh와 polling

callback 경로는 작업을 최종 처리하기 전에 webhook signature도 검증합니다.

provider 결과가 완전히 준비되기 전에 callback이 도착하면 Rivya는 처리를 미루고 upstream status를 다시 확인할 수 있습니다.

성공 경로

성공하면 Rivya는 다음을 수행합니다.

• 결과 URL 저장
• 상태를 SUCCESS로 설정
• 작업 정산
• 생성 기록에서 output을 사용할 수 있게 함
• 생성 성공 알림 생성

그래서 완성된 이미지나 비디오는 페이지를 떠난 뒤에도 계속 볼 수 있습니다.

실패 경로

실패하면 Rivya는 다음을 수행합니다.

• error message 저장
• 상태를 FAILED로 설정
• 예약 이후 발생했고 되돌려야 하는 실패라면 크레딧 환급
• 나중에 확인할 수 있도록 생성 실패 알림 생성

이는 임시 toast와 다릅니다. 실패는 계정 기록의 일부로 남습니다.

작업 상태를 확인할 수 있는 위치

같은 작업은 여러 위치에 나타날 수 있습니다.

• 실행 중일 때의 active Studio
• 정산된 뒤의 History
• 주요 결과를 보여주는 Notifications Center
• /dashboard의 최근 생성 항목

이 공유 상태 덕분에 제품 흐름이 일회성으로 끊기지 않고 일관되게 느껴집니다.

Chat은 어떻게 다른가

Chat도 과금되지만 같은 비동기 작업 기록을 사용하지 않습니다. Chat turn은 다음으로 저장됩니다.

• chat session
• chat message

token 기반 chat model의 경우 Rivya는 먼저 크레딧을 예약한 뒤 사용량이 돌아오면 최종 금액을 정산할 수 있습니다. 최종 금액이 더 낮으면 차액은 환급됩니다.

따라서 큰 규칙은 다음과 같습니다.

• image, video, audio generation은 ai_task를 사용합니다
• chat은 저장된 session과 message-level settlement를 사용합니다

다음에 읽을 문서

• Image Workflows in Rivya
• Video Workflows in Rivya
• Audio Workflows in Rivya
• Credits & Billing
• Troubleshooting in Rivya
• Notifications Center
• History

작업 상태 체크리스트

생성 작업이 헷갈리거나 느리거나 실패했거나 사라진 것처럼 보이면 다음을 확인하세요.

• 먼저 작업 유형을 식별합니다: chat settlement, image, video, audio 또는 tool-backed chat.
• 크레딧이 provider 제출 전에 예약되었는지, 사용량 이후 정산되었는지 확인합니다.
• 결과가 사라졌다고 판단하기 전에 provider callback, polling result, history item, notification을 확인합니다.
• 사용자가 수정할 수 있는 실패와 provider 또는 infrastructure 실패를 구분합니다.
• 같은 prompt를 다시 실행하기 전에 실패한 작업이 크레딧을 되돌려야 하는지 확인합니다.

다시 실행하기 전에 재확인

같은 prompt가 계속 실패하거나, 작업이 너무 오래 진행 중으로 남아 있거나, output 없이 크레딧이 소비된 것처럼 보이거나, 더 무거운 중복 실행을 제출하려는 경우 먼저 재확인하세요.