Rivya API

Rivya-এর multimodal model layer-এর ওপর build করুন

Rivya API product teams-কে নিজেদের apps থেকে Rivya models call করার public, account-based path দেয়। asynchronous image, video এবং audio jobs দিয়ে শুরু করুন, model chat-capable হলে optional SSE streaming সহ Chat API turns যোগ করুন, এবং billing একই Rivya credit wallet-এর মধ্যে রাখুন।
API docs পড়ুনAPI key তৈরি করুন

কুইকস্টার্ট গঠন

মডেল স্তর

Dynamic catalog

বিলিং

Shared credits

First version

Jobs + Chat

অ্যাক্সেস

API keys

মেথডPOST
Endpoint/api/v1/generations

বাস্তব request-এর জন্য Rivya API key এবং available account credits দরকার। Public examples placeholder secrets ব্যবহার করে এবং anonymously models call করে না।

রিকোয়েস্ট
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": 20,
  "result": null,
  "error": null
}

প্রথমে যা ships করে

Rivya product-এর সঙ্গে aligned একটি public API layer

API-টি Rivya product surface হিসেবে designed। এটি Rivya model IDs, Rivya credits, public task states এবং model catalog-এর সঙ্গে connected docs ব্যবহার করে।

Image generation API

prompt এবং supported model parameters দিয়ে image jobs submit করুন, তারপর public results poll করুন।

ভিডিও জেনারেশন API

Studio-তে ব্যবহৃত একই task এবং credit controls দিয়ে asynchronous video jobs চালান।

অডিও জেনারেশন API

একই account, balance এবং history boundary দিয়ে API-accessible audio models ব্যবহার করুন।

শেয়ার্ড ক্রেডিট ওয়ালেট

API calls এবং Studio usage একই Rivya balance থেকে draw করে, reserved credits এবং failure handling সহ।

Start path

Account থেকে প্রথম API request পর্যন্ত

01

একটি key তৈরি করুন

Sign in করুন, Settings-এ API Keys খুলুন, scoped key তৈরি করুন, এবং full secret সঙ্গে সঙ্গে store করুন।

02

একটি model বেছে নিন

submit করার আগে API model reference পড়ুন বা /api/v1/models call করে model IDs, parameters, chat capabilities এবং input readiness inspect করুন।

03

Submit, poll, বা subscribe করুন

idempotent generation request পাঠান, public task endpoint poll করুন, generation callbacks-এর জন্য signed webhooks ব্যবহার করুন, বা optional SSE streaming সহ Chat API turn পাঠান।

Version boundary

Clear scope, hidden promises নয়

landing page future surfaces mention করতে পারে, কিন্তু current product copy unfinished APIs already live বলে imply করা যাবে না।

Chat API

Available

API-created sessions, account credits এবং optional Files API image attachments সহ non-streaming এবং SSE streaming turns-এর জন্য available।

Files API

Available

reference image, video এবং audio uploads-এর জন্য available। কোনো model page params.referenceMediaItems চাইলে generation-এর আগে এটি ব্যবহার করুন।

ইউজার webhooks

Available

succeeded বা failed generation tasks-এর signed callbacks চান এমন production integrations-এর জন্য available।

Online debugger

Request preview করুন, তারপর নিজের API key দিয়ে run করুন

প্রতিটি visitor-এর জন্য debugger mock mode-এ শুরু করে। generation selector এমন non-chat models list করে যা files upload না করেই test করা যায়, আর Files panel signed-in users-কে temporary API key দিয়ে /api/v1/files test করতে দেয়। Chat examples API docs-এ আছে।

অ্যাকাউন্ট অবস্থা

Account check হচ্ছে

সক্রিয় key prefix

আগে key তৈরি করুন

বর্তমান ক্রেডিট

check করতে sign in করুন

Mock previewLive Public APIActive API key নেই

Mock mode কখনো model call করে না এবং credits consume করে না।

শুধু এই request-এর জন্য key paste করুন। refresh-এর পর debugger এটি store করে না।

Files API আপলোড টেস্ট

POST /api/v1/files দিয়ে reference media upload করুন, তারপর returned URL এবং duration token copy করে reference inputs support করে এমন model-এর params.referenceMediaItems-এ দিন।

Mock কখনো upload করে নাLive /api/v1/files ব্যবহার করে

selected model allowed MIME types, size এবং duration rules নিয়ন্ত্রণ করে। Live uploads-এর জন্য আপনার temporary API key দরকার এবং real upload service call হতে পারে।

API key তৈরি করুনAPI docs পড়ুন
রিকোয়েস্ট প্রিভিউ
{
  "model": "z-image",
  "prompt": "clean studio set-এ editorial product photo",
  "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 bodies, responses, idempotency, model parameters এবং error codes পড়ুন।

Docs খুলুন

API key management

protected Settings area থেকে API keys create, copy once, revoke এবং rotate করুন।

Keys manage করুন

অনলাইন ডিবাগিং

আগে mock examples ব্যবহার করুন; real debugging-এর জন্য login, API key এবং account credits দরকার।

Flow preview করুন