Rivya API পরিচিতি

স্থাপনায় প্রকাশ্য API প্রবেশাধিকার সক্রিয় এবং আপনার অ্যাকাউন্টে ব্যবহারযোগ্য থাকলে নিজের পণ্য থেকে সমর্থিত Rivya মডেলের সক্ষমতা কল করার ডেভেলপার চুক্তি হলো Rivya API v1।

বাস্তবায়িত চুক্তিতে অসমকালীন ছবি, ভিডিও ও অডিও তৈরি এবং স্ট্রিমবিহীন বা SSE স্ট্রিমিং উত্তরসহ Chat API-র বার্তা অন্তর্ভুক্ত। এতে Rivya model ID, Rivya অ্যাকাউন্ট ক্রেডিট, তৈরির জন্য প্রকাশ্য কাজের ID এবং Chat API-র জন্য সার্ভার-পাশের Chat সেশন ব্যবহৃত হয়। কোনো পথ নথিভুক্ত থাকার অর্থ এই নয় যে প্রতিটি পরিবেশ, অ্যাকাউন্ট বা তালিকার মডেলে সেটি কল করা যাবে; সংযোগের আগে বর্তমান প্রবেশাধিকার ও মডেলের প্রস্তুতি নিশ্চিত করুন।

API কোন কাজে ব্যবহার করবেন

নিচের কাজগুলো করতে চাইলে API ব্যবহার করুন:

• নিজের অ্যাপ থেকে ছবি, ভিডিও বা অডিও তৈরির কাজ পাঠানো

• স্ট্রিমবিহীন বা স্ট্রিমিং Chat-এর বার্তা পাঠানো এবং API-তে তৈরি Chat সেশন চালিয়ে যাওয়া

• একই Rivya অ্যাকাউন্ট ক্রেডিট ওয়ালেটের মধ্যে বিল রাখা

• প্রকাশ্য কাজের ID দিয়ে কাজের অবস্থা বারবার দেখা

• উৎপাদন অনুরোধ নিরাপদে আবার পাঠাতে idempotency-ভিত্তিক পুনরায় চেষ্টা ব্যবহার করা

• Studio ও API-র ব্যবহার একই অ্যাকাউন্ট সীমার মধ্যে রাখা

API হলো Rivya পণ্যের একটি স্তর। প্রকাশ্য উত্তরে শুধু Rivya-র নাম ও প্রকাশ্য ক্ষেত্র ব্যবহার করা হয়।

বর্তমান সংস্করণের পরিধি

বাস্তবায়িত v1 এন্ডপয়েন্টের মধ্যে আছে:

• GET /api/v1/models

• POST /api/v1/generations

• POST /api/v1/files

• GET /api/v1/files/{fileId}

• POST /api/v1/chat/completions

• GET /api/v1/chat/sessions

• GET /api/v1/chat/sessions/{sessionId}

• GET /api/v1/generations/{taskId}

• GET /api/v1/credits

• GET /api/v1/webhooks

• POST /api/v1/webhooks

• GET /api/v1/webhook-events

• GET /api/v1/openapi.json

বর্তমান চুক্তিতে অসমকালীন তৈরির ফলাফলের জন্য স্বাক্ষরিত webhook, Chat API এবং সার্ভার-পাশের স্ট্রিমিং-সহ TypeScript SDK beta রয়েছে। Webhook অনুরোধের জন্য স্থাপনায় webhook সুবিধা ও প্রকাশ্য API প্রবেশাধিকার—দুটিই সক্রিয় থাকতে হবে।

পরিচয় যাচাই

তৈরি, অবস্থা ও ক্রেডিট এন্ডপয়েন্টে প্রয়োজন:

Authorization: Bearer rvya_sk_...

API কী-এর বিন্যাস থেকে কী তৈরি ও পরিবর্তন করুন। উৎপাদনে কী ব্যবহারের আগে API পরিচয় যাচাই পড়ুন।

বিলের ধরন

API অনুরোধ Studio-র একই Rivya অ্যাকাউন্ট ক্রেডিট ব্যবহার করে।

কাজ শুরু হলে তৈরির জন্য ক্রেডিট সংরক্ষণ বা খরচ করা হয়। Chat-এর বার্তায় মডেল কলের আগে ক্রেডিট সংরক্ষণ করা হয় এবং সহকারীর বার্তা সংরক্ষণের সময় টোকেন ব্যবহার থেকে চূড়ান্ত ক্রেডিট নিষ্পত্তি হয়। বর্তমান Rivya ব্যর্থতা-সংক্রান্ত নিয়মে তৈরি বা Chat-এর বার্তা ব্যর্থ হলে একই ফেরত-ব্যবস্থা প্রযোজ্য।

ব্যবহারকারীর দৃশ্যমান ওয়ালেটের নিয়ম জানতে API ক্রেডিট এবং Rivya-তে ক্রেডিট ও বিল পড়ুন।

প্রথম সংযোগের পথ

1. বিন্যাসে API কী তৈরি করুন।

2. প্রকাশ্য model ID বেছে নিতে API মডেলের তালিকা কল করুন।

3. মডেলের পরামিতির জন্য মডেলের API নির্দেশিকা পড়ুন।

4. মডেলে রেফারেন্স মাধ্যম প্রয়োজন হলে ফাইলস API দিয়ে আপলোড করুন।

5. তৈরির অনুরোধ পাঠান দিয়ে কাজ পাঠান।

6. কাজ সফল বা ব্যর্থ না হওয়া পর্যন্ত তৈরির অবস্থা দেখুন। স্থাপনা ও অ্যাকাউন্টে webhook সক্রিয় থাকলে স্বাক্ষরিত সমাপ্তির ঘটনার জন্য API Webhooks দিয়ে সদস্য হতে পারেন।

7. Chat মডেলের জন্য তৈরির সংযোগবিন্দুর বদলে Chat API ব্যবহার করুন। Chat-এর ছবির সংযুক্তিতে অবশ্যই ফাইলস API-র file_id মান দিতে হবে।

সম্পর্কিত পাতা

• API দ্রুত সূচনা

• API পরিচয় যাচাই

• Rivya TypeScript SDK

• মডেলের API নির্দেশিকা

• Chat API

• API Webhooks

• API-র ত্রুটি ও সীমা