API কী তৈরি করুন, মডেল বেছে নিন, অসমকালীন তৈরির কাজ পাঠান এবং ঐচ্ছিক SSE স্ট্রিমিং-সহ Chat API-র বার্তা পাঠান।

এই দ্রুত সূচনায় অ্যাকাউন্টের বিন্যাস থেকে Rivya API-তে একটি তৈরির কাজ এবং প্রথম Chat API বার্তা পাঠানো পর্যন্ত সবচেয়ে সংক্ষিপ্ত নিরাপদ পথ দেখানো হয়েছে।

নথি ও উদাহরণে নমুনা কী ব্যবহার করুন। প্রকৃত API কী কখনও প্রকাশ্য কোড, পর্দার ছবি, সহায়তা অনুরোধ বা ভাগ করা নথিতে বসাবেন না।

উদাহরণগুলো বাস্তবায়িত প্রকাশ্য API v1 চুক্তি দেখায়। পরীক্ষা করার আগে স্থাপনায় প্রকাশ্য API সক্রিয় ও অ্যাকাউন্টে ব্যবহারযোগ্য কি না নিশ্চিত করুন। কোনো সংযোগবিন্দু বা মডেল পাতা নথিভুক্ত থাকার অর্থ এই নয় যে প্রতিটি পরিবেশে অনুরোধটি চলবে।

1. API কী তৈরি করুন

API কী-এর বিন্যাস খুলে কী তৈরি করুন, সম্পূর্ণ গোপন মানটি একবার কপি করুন এবং সার্ভার-পাশের পরিবেশে সংরক্ষণ করুন।

প্রথমবারের জন্য প্রস্তাবিত অনুমতির পরিধি:

models:read
generations:create
generations:read
files:create
files:read
credits:read
webhooks:manage
chat:create
chat:read

2. মূল URL নিশ্চিত করুন

উৎপাদনের API মূল URL ব্যবহার করুন:

https://rivya.ai

localhost URL শুধু স্থানীয় উন্নয়নের জন্য। প্রকাশ্য উদাহরণে স্থানীয় গোপন মান ব্যবহার করা উচিত নয়।

3. মডেলের তালিকা দেখুন

curl https://rivya.ai/api/v1/models

তৈরির অনুরোধে উত্তরের id ক্ষেত্রটিকে model-এর মান হিসেবে ব্যবহার করুন।

4. তৈরির অনুরোধ পাঠান

curl https://rivya.ai/api/v1/generations \
  -H "Authorization: Bearer rvya_sk_..." \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: quickstart-001" \
  -d '{
    "model": "z-image",
    "prompt": "A clean editorial product image on a soft studio background"
  }'

উত্তরে প্রকাশ্য কাজের ID পাওয়া যায়। পরে অবস্থা দেখার জন্য এটি সংরক্ষণ করুন।

5. কাজের অবস্থা দেখুন

curl https://rivya.ai/api/v1/generations/task_public_id \
  -H "Authorization: Bearer rvya_sk_..."

অবস্থার মান:

queued
processing
succeeded
failed

6. ক্রেডিট যাচাই করুন

curl https://rivya.ai/api/v1/credits \
  -H "Authorization: Bearer rvya_sk_..."

পরীক্ষার আগে বা পরে বর্তমান অ্যাকাউন্ট ব্যালান্স নিশ্চিত করতে এটি ব্যবহার করুন।

7. ঐচ্ছিক: Webhook যোগ করুন

স্থাপনা ও অ্যাকাউন্টে webhook প্রবেশাধিকার সক্রিয় থাকলে এবং আপনার সার্ভার আগত HTTPS প্রত্যুত্তর নিতে পারলে একটি webhook সংযোগবিন্দু তৈরি করুন:

curl https://rivya.ai/api/v1/webhooks \
  -H "Authorization: Bearer rvya_sk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Production webhook",
    "url": "https://example.com/rivya/webhook",
    "event_types": ["generation.succeeded", "generation.failed"]
  }'

উত্তর থেকে একবার দেখানো signing_secret সংরক্ষণ করুন এবং পাঠানো তথ্য বিশ্বাস করার আগে প্রতিটি সরবরাহ যাচাই করুন।

8. ঐচ্ছিক: Chat-এর বার্তা পাঠান

Chat মডেলের জন্য POST /api/v1/generations-এর বদলে Chat API কল করুন:

curl https://rivya.ai/api/v1/chat/completions \
  -H "Authorization: Bearer rvya_sk_..." \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: quickstart-chat-001" \
  -d '{
    "model": "claude-sonnet-5-chat",
    "message": "Write a concise launch plan for a new product image campaign"
  }'

API-তে তৈরি সেশন চালিয়ে যেতে ফেরত পাওয়া session_id ব্যবহার করুন। ছবির সংযুক্তিতে অবশ্যই ফাইলস API-র file_id মান দিতে হবে।

ঐচ্ছিক: TypeScript SDK Beta ব্যবহার করুন

সার্ভার-পাশের TypeScript সংযোগে স্থানীয় SDK পরীক্ষামূলক সংস্করণ ব্যবহার করা যায়:

import { RivyaClient } from "@rivya/sdk";

const rivya = new RivyaClient({
  apiKey: process.env.RIVYA_API_KEY
});

const generation = await rivya.generations.create({
  model: "z-image",
  prompt: "A clean editorial product image on a soft studio background"
});

ব্যবহারের আগে Rivya TypeScript SDK পড়ুন। ব্যক্তিগত SDK beta-তে সার্ভার-পাশের Chat স্ট্রিমিং সমর্থন রয়েছে।

Rivya API দ্রুত শুরু