01
একটি API key তৈরি করুন
সাইন ইন করুন, Settings-এ API Keys খুলুন, scoped key তৈরি করুন, এবং পূর্ণ secret সঙ্গে সঙ্গে সংরক্ষণ করুন।
Rivya API
Rivya-এর মাল্টিমোডাল মডেল স্তরের ওপর তৈরি করুন
Rivya API পণ্য দলকে নিজেদের অ্যাপ থেকে Rivya মডেল কল করার জন্য প্রকাশ্য, অ্যাকাউন্ট-ভিত্তিক পথ দেয়। অ্যাসিঙ্ক্রোনাস ছবি, ভিডিও এবং অডিও কাজ দিয়ে শুরু করুন, মডেল Chat-সক্ষম হলে ঐচ্ছিক SSE streaming সহ Chat API turn যোগ করুন, এবং বিলিং একই Rivya ক্রেডিট ওয়ালেটে রাখুন।
কুইকস্টার্ট গঠন
মডেল স্তর
ডাইনামিক ক্যাটালগ
বিলিং
শেয়ার করা ক্রেডিট
প্রথম সংস্করণ
কাজ + Chat
অ্যাক্সেস
API কী
মেথডPOST
Endpoint/api/v1/generations
বাস্তব রিকোয়েস্টের জন্য Rivya API key এবং উপলভ্য অ্যাকাউন্ট ক্রেডিট দরকার। Public উদাহরণ placeholder secret ব্যবহার করে এবং অজ্ঞাতভাবে মডেল কল করে না।
রিকোয়েস্ট
curl https://rivya.ai/api/v1/generations \
-H "Authorization: Bearer rvya_sk_..." \
-H "Content-Type: application/json" \
-H "Idempotency-Key: demo-job-001" \
-d '{
"model": "z-image",
"prompt": "Editorial product photo on a clean studio set"
}'রেসপন্স
{
"id": "task_public_id",
"status": "queued",
"model": "z-image",
"reserved_credits": 1,
"result": null,
"error": null
}প্রথমে যা প্রকাশিত
Rivya পণ্যের সঙ্গে সামঞ্জস্যপূর্ণ একটি public API স্তর
API Rivya product-এর অংশ। এটি Rivya model ID, Rivya credits, public task state এবং model catalog-এর সঙ্গে যুক্ত documentation ব্যবহার করে।
ছবি জেনারেশন API
প্রম্পট এবং সমর্থিত মডেল parameter দিয়ে ছবি কাজ জমা দিন, তারপর public result poll করুন।
ভিডিও জেনারেশন API
Studio-তে ব্যবহৃত একই task এবং credit control দিয়ে অ্যাসিঙ্ক্রোনাস ভিডিও কাজ চালান।
অডিও জেনারেশন API
একই অ্যাকাউন্ট, ব্যালেন্স এবং ইতিহাস সীমা দিয়ে API-accessible অডিও মডেল ব্যবহার করুন।
শেয়ার করা ক্রেডিট ওয়ালেট
API call এবং Studio ব্যবহার একই Rivya ব্যালেন্স থেকে নেয়, reserved credits এবং failure handling সহ।
শুরুর পথ
অ্যাকাউন্ট থেকে প্রথম API request পর্যন্ত
02
একটি মডেল বেছে নিন
জমা দেওয়ার আগে API model reference পড়ুন বা /api/v1/models কল করে model ID, parameter, chat capability এবং input readiness দেখুন।
03
জমা দিন, poll করুন, বা subscribe করুন
idempotent generation request পাঠান, public task endpoint poll করুন, generation callback-এর জন্য signed webhook ব্যবহার করুন, বা ঐচ্ছিক SSE streaming সহ Chat API turn পাঠান।
সংস্করণ সীমা
পরিষ্কার পরিসর, গোপন প্রতিশ্রুতি নয়
আজ কোন API capability available এবং কোনগুলো ভবিষ্যতে যোগ হবে, এই page তা আলাদা করে দেখায়—যাতে আপনি বর্তমান live capability ধরেই পরিকল্পনা করতে পারেন।
Chat API
উপলভ্যAPI-created session, অ্যাকাউন্ট ক্রেডিট এবং ঐচ্ছিক Files API ছবি attachment সহ non-streaming এবং SSE streaming turn-এর জন্য উপলভ্য।
Files API
উপলভ্যreference image, video এবং audio upload-এর জন্য উপলভ্য। কোনো মডেল পেজ params.referenceMediaItems চাইলে generation-এর আগে এটি ব্যবহার করুন।
ব্যবহারকারী webhooks
উপলভ্যsucceeded বা failed generation task-এর signed callback চান এমন production integration-এর জন্য উপলভ্য।
অনলাইন ডিবাগার
রিকোয়েস্ট preview করুন, তারপর নিজের API key দিয়ে চালান
প্রতিটি ভিজিটরের জন্য ডিবাগার mock mode-এ শুরু করে। generation selector এমন non-chat model তালিকাভুক্ত করে যা file upload না করেই পরীক্ষা করা যায়, আর Files panel সাইন-ইন করা ব্যবহারকারীদের temporary API key দিয়ে /api/v1/files পরীক্ষা করতে দেয়। Chat উদাহরণ API docs-এ আছে।
অ্যাকাউন্ট অবস্থা
অ্যাকাউন্ট পরীক্ষা হচ্ছে
সক্রিয় key prefix
আগে API key তৈরি করুন
বর্তমান ক্রেডিট
পরীক্ষা করতে সাইন ইন করুন
Mock previewLive Public APIসক্রিয় API key নেই
Mock mode কখনো মডেল কল করে না এবং ক্রেডিট ব্যবহার করে না।
শুধু এই রিকোয়েস্টের জন্য key paste করুন। refresh-এর পর ডিবাগার এটি সংরক্ষণ করে না।
Files API আপলোড টেস্ট
POST /api/v1/files দিয়ে reference media upload করুন, তারপর returned URL এবং duration token copy করে reference input support করে এমন মডেলের params.referenceMediaItems-এ দিন।
Mock কখনো আপলোড করে নাLive /api/v1/files ব্যবহার করে
নির্বাচিত মডেল allowed MIME type, size এবং duration rule নিয়ন্ত্রণ করে। Live upload-এর জন্য আপনার temporary API key দরকার এবং real upload service call হতে পারে।
রিকোয়েস্ট প্রিভিউ
{
"model": "z-image",
"prompt": "পরিচ্ছন্ন স্টুডিও সেটে সম্পাদকীয় পণ্যের ছবি",
"params": {
"aspect_ratio": "1:1"
}
}রেসপন্স
{
"id": "mock_task_001",
"status": "queued",
"model": "z-image",
"reserved_credits": 1,
"final_credits": 0,
"result": null,
"error": null
}Files API রেসপন্স
{
"id": "file_mock_001",
"object": "file",
"kind": "image",
"file_name": "reference.png",
"mime_type": "image/png",
"size_bytes": 245760,
"url": "https://media.example/reference.png",
"duration_seconds": null,
"duration_token": null,
"created_at": "2026-05-11T00:00:00.000Z",
"expires_at": null
}জেনারেশন params
{
"params": {
"referenceMediaItems": [
{
"url": "https://media.example/reference.png",
"kind": "image",
"name": "reference.png",
"mimeType": "image/png"
}
]
}
}টাস্ক অবস্থা
আনুমানিক বেস ক্রেডিট
1
স্ট্যাটাস
queued
API ডকুমেন্টেশন
authentication, request body, response, idempotency, model parameter এবং error code পড়ুন।
ডকস খুলুনAPI key ব্যবস্থাপনা
সুরক্ষিত Settings area থেকে API key তৈরি, একবার কপি, বাতিল এবং রোটেট করুন।
Key পরিচালনা করুনঅনলাইন ডিবাগিং
আগে mock উদাহরণ ব্যবহার করুন; বাস্তব debugging-এর জন্য লগইন, API key এবং অ্যাকাউন্ট ক্রেডিট দরকার।
Flow preview করুন