Rivya Task Lifecycle Guide

Rivya-তে image, video, বা audio generation task submit করার পরে কী ঘটে তা বুঝতে হলে এই guide ব্যবহার করুন।

এটি task states, credit reservation, provider completion, history, notifications, এবং failed-task handling এক জায়গায় explain করে।

Real Task States

current async generation lifecycle চারটি visible states ব্যবহার করে:

• WAITING
• GENERATING
• SUCCESS
• FAILED

এই states ai_task-এ stored থাকে এবং Studio, history, dashboard, ও notifications flow জুড়ে reused হয়।

Submit করলে কী ঘটে

1. Rivya request validate করে

provider-এর কাছে কিছু যাওয়ার আগে Rivya check করে:

• model exists কি না
• ওই model-এর জন্য direct generation enabled কি না
• runtime async-task based কি না
• prompt length valid কি না
• form parameters normalized কি না
• reference files model যা accepts করে তার সঙ্গে match করে কি না

কিছু models-এর extra rules আছে। যেমন, audio isolation-এর জন্য uploaded audio file এবং duration verification দরকার।

2. Rivya task record তৈরি করে

Rivya আগে একটি ai_task entry তৈরি করে, status WAITING সহ।

সেই record model, category, prompt, params, reserved credits, billing type, এবং পরে result বা failure state store করে।

3. Provider submission-এর আগে Credits consumed হয়

এটি গুরুত্বপূর্ণ: async generation-এর জন্য Rivya job upstream পাঠানোর আগে task credits spend করে।

credits too low হলে:

• task failed হিসেবে marked হয়
• upstream service কখনও called হয় না
• insufficient-credit notification তৈরি হতে পারে

4. Provider job তৈরি হয়

credits available হলে Rivya matching upstream service-এ task submit করে এবং upstream task ID store করে।

সেই সময়ে status GENERATING-এ যায়।

Rivya কীভাবে Result জানতে পারে

Rivya দুটি completion paths support করে:

• callback-enabled environments-এ provider callback
• callback completion available না হলে status refresh এবং polling

callback path task finalize করার আগে webhook signature-ও verify করে।

provider result পুরো ready হওয়ার আগে callback এলে Rivya defer করে upstream status check করে আবার try করতে পারে।

Success Path

success হলে Rivya:

• result URLs store করে
• status SUCCESS করে
• task settle করে
• output generation history-তে available করে
• generation-success notification তৈরি করে

এই কারণেই page ছেড়ে যাওয়ার পরেও finished image বা video visible থাকে।

Failure Path

failure হলে Rivya:

• error message store করে
• status FAILED করে
• reservation-এর পরে failure হয়ে থাকলে এবং reverse করা উচিত হলে credits refund করে
• durable review-এর জন্য generation-failed notification তৈরি করে

এটি temporary toast থেকে আলাদা। failure account-এর record-এর অংশ হয়ে যায়।

Task State কোথায় দেখবেন

একই task কয়েক জায়গায় দেখা যেতে পারে:

• running থাকা অবস্থায় active Studio-তে
• settle হওয়ার পরে History-তে
• major outcomes-এর জন্য Notifications Center-এ
• recent generations হিসেবে /dashboard-এ

এই shared state-ই product-কে disposable না হয়ে coherent মনে করায়।

Chat কীভাবে আলাদা

Chat-ও billable, কিন্তু একই async task record ব্যবহার করে না। Chat turns stored হয়:

• chat sessions
• chat messages

token-based chat models-এর জন্য Rivya আগে credits reserve করতে পারে, তারপর usage ফিরে এলে final amount settle করে। final amount কম হলে difference refund হয়।

তাই broad rule হলো:

• image, video, এবং audio generation ai_task ব্যবহার করে
• chat saved sessions এবং message-level settlement ব্যবহার করে

Read Next

• Rivya-তে Image Workflows
• Rivya-তে Video Workflows
• Rivya-তে Audio Workflows
• Credits & Billing
• Rivya-তে Troubleshooting
• Notifications Center
• History

Task State Checklist

generation confusing, slow, failed, বা missing হলে check করুন:

• প্রথমে task type identify করুন: chat settlement, image, video, audio, বা tool-backed chat।
• credits provider submission-এর আগে reserved হয়েছিল নাকি usage-এর পরে settled হয়েছে তা check করুন।
• result lost ধরে নেওয়ার আগে provider callback, polling result, history item, এবং notification খুঁজুন।
• user-correctable failures-কে provider বা infrastructure failures থেকে আলাদা করুন।
• একই prompt rerun করার আগে failed task credits reverse করা উচিত কি না confirm করুন।

আবার Run করার আগে Recheck করুন

same prompt বারবার fail করলে, task অনেকক্ষণ in progress থাকলে, credits output ছাড়া consumed দেখালে, অথবা heavier duplicate run submit করতে গেলে recheck করুন।