Rivya Public API v1 দিয়ে HappyHorse 1.0 ব্যবহার করুন: মডেল আইডি happyhorse-1-0, সমর্থিত ইনপুট, প্যারামিটার, Files API-র নিয়ম, ক্রেডিট ও উত্তরের উদাহরণসহ।

API দিয়ে উপলভ্যটেক্সট বা URL প্রস্তুত; রেফারেন্স মোডে Files API ব্যবহার করা হয়ভিডিও

API মডেল আইডি

happyhorse-1-0

ইনপুট

text, file

Files API

রেফারেন্স মোডের জন্য প্রয়োজন

বেস ক্রেডিট

per_output_second · 720p=28 · 1080p=48 · ⌈total⌉

ক্ষমতা

ভিডিও

বিলিং

METERED

প্রম্পট সীমা

5000 অক্ষর

অনুরোধের চুক্তি

মডেল আইডি শীর্ষ স্তরে পাঠান। মডেল-নির্দিষ্ট নিয়ন্ত্রণ params-এ থাকবে।

কী	ধরন	প্রয়োজনীয়	ডিফল্ট	বিবরণ
model	string	হ্যাঁ	happyhorse-1-0	happyhorse-1-0 API মডেল আইডি ব্যবহার করুন।
prompt	string	হ্যাঁ	-	এই মডেলের জন্য সর্বোচ্চ 5000 অক্ষর।
params	object	না	-	মডেল-নির্দিষ্ট প্যারামিটার অবজেক্ট। অনুমোদিত key-গুলোর জন্য নিচের সারি দেখুন।
client_request_id	string	না	-	আপনার সিস্টেমে অনুরোধ শনাক্ত করার ঐচ্ছিক ক্লায়েন্ট-পক্ষের আইডি।

মডেল প্যারামিটার

কী	ধরন	প্রয়োজনীয়	ডিফল্ট	পরিসর	বিকল্প	বিবরণ
resolution	select	না	1080p	-	720p, 1080p	রেজোলিউশন
aspect_ratio	select	না	16:9	-	16:9, 9:16, 1:1, 4:3, 3:4	Aspect ratio
duration	number	না	5	min 3 / max 15	-	সময়কাল
seed	number	না	0	min 0 / max 2147483647	-	প্রতিবার নতুন random result চাইলে empty রাখুন। একই integer reuse করলে আগের result reproduce বা fine-tune করা সহজ হয়। Prompt এবং অন্য key setting একই রকম থাকলেই শুধু result কাছাকাছি থাকে, এবং এটি guaranteed 1:1 match নয়।

আপলোড নীতি

প্রথমে রেফারেন্স ফাইল আপলোড করুন, তারপর পাওয়া URL ও দৈর্ঘ্যের টোকেন `params.referenceMediaItems`-এর মধ্যে দিন।

রেফারেন্স নিয়ম

রেফারেন্স media: Image-to-video-এর জন্য ঠিক 1টি ছবি, আর reference video-এর জন্য 2 থেকে 9টি ছবি ব্যবহার করুন। ছবি JPEG, PNG বা WebP হতে হবে এবং 10 MB-এর বেশি নয়; single-image mode-এ width ও height উভয়ই অন্তত 300 px এবং reference mode-এ ছোট পাশ অন্তত 400 px হতে হবে।

সর্বোচ্চ ফাইল

সমর্থিত ফাইল ধরন

image

দৈর্ঘ্যের টোকেন

দৈর্ঘ্য যাচাইয়ের প্রয়োজন হলে ভিডিও ও অডিও রেফারেন্স `/api/v1/files` থেকে durationToken বহন করবে।

kind	সর্বোচ্চ আকার	MIME ধরন
image	10 MB	image/jpeg, image/png, image/webp

ন্যূনতম অনুরোধ

{
  "model": "happyhorse-1-0",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "resolution": "1080p",
    "aspect_ratio": "16:9",
    "duration": 5,
    "seed": 0
  }
}

রেফারেন্স ফাইল রিকোয়েস্ট

{
  "model": "happyhorse-1-0",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "resolution": "1080p",
    "aspect_ratio": "16:9",
    "duration": 5,
    "seed": 0,
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png"
      }
    ]
  }
}

জেনারেশন তৈরির উত্তর

জেনারেশন তৈরির এন্ডপয়েন্ট উন্মুক্ত কাজের আইডি ফেরত দেয়। কাজটি `succeeded` বা `failed` না হওয়া পর্যন্ত স্ট্যাটাস এন্ডপয়েন্ট পরীক্ষা করুন।

{
  "id": "task_happyhorse_1_0_example",
  "status": "queued",
  "model": "happyhorse-1-0",
  "reserved_credits": 28,
  "final_credits": 0,
  "settlement_status": "RESERVED",
  "created_at": "2026-05-11T00:00:00.000Z",
  "updated_at": "2026-05-11T00:00:00.000Z",
  "result": null,
  "error": null
}

সাধারণ ত্রুটি

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

কিছু মোডের জন্য Files API-তে রেফারেন্স আপলোড করতে হয়।

HappyHorse 1.0 API ইন্টিগ্রেশন