একটি API কী তৈরি করুন
সাইন ইন করে সেটিংসে API কী খুলুন, প্রয়োজনীয় অনুমতির কী তৈরি করুন এবং সম্পূর্ণ গোপন মানটি সঙ্গে সঙ্গে নিরাপদে সংরক্ষণ করুন।
Rivya API
দ্রুত শুরুর গঠন
মডেল স্তর
গতিশীল তালিকা
বিলিং
অভিন্ন ক্রেডিট
প্রথম সংস্করণ
কাজ + চ্যাট
প্রবেশাধিকার
API কী
বাস্তব অনুরোধের জন্য Rivya API কী ও পর্যাপ্ত অ্যাকাউন্ট ক্রেডিট দরকার। প্রকাশ্য উদাহরণে নমুনা গোপন মান ব্যবহৃত হয় এবং পরিচয় ছাড়া মডেল কল করা হয় না।
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
}অনলাইন ডিবাগার
প্রতিটি দর্শকের জন্য ডিবাগার নমুনা পদ্ধতিতে শুরু হয়। তৈরির মডেল নির্বাচকে এমন চ্যাটবহির্ভূত মডেল থাকে, যেগুলো ফাইল আপলোড ছাড়াই পরীক্ষা করা যায়। ফাইল আপলোড অংশে সাইন-ইন করা ব্যবহারকারী সাময়িক API কী দিয়ে /api/v1/files পরীক্ষা করতে পারেন। চ্যাটের উদাহরণ API নথিতে আছে।
অ্যাকাউন্ট অবস্থা
অ্যাকাউন্ট পরীক্ষা হচ্ছে
চালু কীর উপসর্গ
আগে API কী তৈরি করুন
বর্তমান ক্রেডিট
পরীক্ষা করতে সাইন ইন করুন
নমুনা পদ্ধতি কখনো মডেল কল করে না এবং ক্রেডিট ব্যবহার করে না।
শুধু এই অনুরোধের জন্য কী লিখুন। পাতা হালনাগাদের পর ডিবাগার এটি সংরক্ষণ করে না।
Files API আপলোড পরীক্ষা
POST /api/v1/files দিয়ে রেফারেন্স মাধ্যম আপলোড করুন। এরপর পাওয়া URL ও সময়কালের টোকেন নিয়ে রেফারেন্স ইনপুট সমর্থনকারী মডেলের params.referenceMediaItems-এ দিন।
নির্বাচিত মডেল গ্রহণযোগ্য MIME ধরন, আকার ও সময়কালের নিয়ম নির্ধারণ করে। বাস্তব আপলোডের জন্য সাময়িক API কী দরকার এবং প্রকৃত আপলোড সেবা কল করা হতে পারে।
{
"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
}{
"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": {
"referenceMediaItems": [
{
"url": "https://media.example/reference.png",
"kind": "image",
"name": "reference.png",
"mimeType": "image/png",
"sizeBytes": 245760
}
]
}
}কাজের অবস্থা
আনুমানিক বেস ক্রেডিট
1
স্ট্যাটাস
queued
শুরুর পথ
সাইন ইন করে সেটিংসে API কী খুলুন, প্রয়োজনীয় অনুমতির কী তৈরি করুন এবং সম্পূর্ণ গোপন মানটি সঙ্গে সঙ্গে নিরাপদে সংরক্ষণ করুন।
জমা দেওয়ার আগে API মডেল রেফারেন্স পড়ুন বা /api/v1/models কল করে মডেল আইডি, প্যারামিটার, চ্যাট সক্ষমতা ও ইনপুট প্রস্তুতি দেখুন।
আইডেমপোটেন্সিসহ তৈরির অনুরোধ পাঠান, প্রকাশ্য কাজের এন্ডপয়েন্টে নির্দিষ্ট বিরতিতে অবস্থা যাচাই করুন, তৈরির কাজের স্বয়ংক্রিয় প্রতিক্রিয়ার জন্য স্বাক্ষরিত ওয়েবহুক ব্যবহার করুন অথবা ঐচ্ছিক SSE প্রবাহসহ Chat API-তে কথোপকথনের পালা পাঠান।
প্রথমে যা প্রকাশিত
API Rivya পণ্যের অংশ। এটি Rivya মডেল আইডি, Rivya ক্রেডিট, প্রকাশ্য কাজের অবস্থা ও মডেল তালিকার সঙ্গে সামঞ্জস্যপূর্ণ নথি ব্যবহার করে।
প্রম্পট ও সমর্থিত মডেল প্যারামিটার দিয়ে ছবি তৈরির কাজ জমা দিন, তারপর প্রকাশ্য ফলাফলের অবস্থা নির্দিষ্ট বিরতিতে যাচাই করুন।
Studio-তে ব্যবহৃত একই কাজ ও ক্রেডিট নিয়ন্ত্রণ দিয়ে পটভূমিতে ভিডিও তৈরির কাজ চালান।
একই অ্যাকাউন্ট, ব্যালান্স ও ইতিহাসের সীমায় API দিয়ে চালানো যায় এমন অডিও মডেল ব্যবহার করুন।
API কল ও Studio-র ব্যবহার একই Rivya ব্যালান্স থেকে ক্রেডিট নেয়; আগে থেকে সংরক্ষিত ক্রেডিট ও ব্যর্থতা সামলানোর নিয়মও একই।
সংস্করণ সীমা
আজ কোন API সক্ষমতা চালু এবং কোনগুলো ভবিষ্যতে যোগ হবে, এই পাতা তা আলাদা করে দেখায়—যাতে আপনি বর্তমান চালু সক্ষমতা ধরেই পরিকল্পনা করতে পারেন।
API-তে তৈরি সেশন, অ্যাকাউন্ট ক্রেডিট ও ঐচ্ছিক Files API ছবি সংযুক্তিসহ সাধারণ ও SSE প্রবাহের কথোপকথনের পালার জন্য চালু।
রেফারেন্স ছবি, ভিডিও ও অডিও আপলোডের জন্য চালু। কোনো মডেলের পাতা params.referenceMediaItems চাইলে তৈরির কাজের আগে এটি ব্যবহার করুন।
সফল বা ব্যর্থ তৈরির কাজের স্বাক্ষরিত স্বয়ংক্রিয় প্রতিক্রিয়া দরকার এমন প্রযোজনা সমন্বয়ের জন্য চালু।
প্রমাণীকরণ, অনুরোধের মূল অংশ, প্রতিক্রিয়া, আইডেমপোটেন্সি, মডেল প্যারামিটার ও ত্রুটি কোড পড়ুন।
ডকস খুলুনএকটি API কী তৈরি করে একবার অনুলিপি করুন। বদলাতে হলে সুরক্ষিত সেটিংস অংশে নতুন কী তৈরি করে পুরোনোটি বাতিল করুন।
কী পরিচালনা করুনআগে নমুনা উদাহরণ ব্যবহার করুন; বাস্তব ত্রুটি খোঁজার জন্য সাইন-ইন, API কী ও অ্যাকাউন্ট ক্রেডিট দরকার।
প্রক্রিয়ার ঝলক দেখুন