Rivya Public API v1 দিয়ে Topaz Image Upscaler ব্যবহার করুন: মডেল আইডি topaz-image-upscale, সমর্থিত ইনপুট, প্যারামিটার, Files API-র নিয়ম, ক্রেডিট ও উত্তরের উদাহরণসহ।

API দিয়ে উপলভ্যপ্রস্তুতিছবি

API মডেল আইডি

topaz-image-upscale

ইনপুট

file

Files API

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

বেস ক্রেডিট

per_image · 2K=10 · 4K=20 · 8K=40 · ⌈total⌉

ক্ষমতা

ছবি

বিলিং

FIXED

প্রম্পট সীমা

নথিভুক্ত প্রম্পট সীমা নেই

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

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

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

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

কী	ধরন	প্রয়োজনীয়	ডিফল্ট	পরিসর	বিকল্প	বিবরণ
upscale_factor	select	না	2	-	1, 2, 4	আপস্কেল গুণক

আপলোড নীতি

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

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

Source image: শুধু ১টি JPEG, PNG বা WebP, সর্বোচ্চ ১০ MB; বড় করার পর দীর্ঘতম প্রান্ত ≤ ৮১৯২ px।

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

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

image

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

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

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

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

{
  "model": "topaz-image-upscale",
  "params": {
    "upscale_factor": "2"
  }
}

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

{
  "model": "topaz-image-upscale",
  "params": {
    "upscale_factor": "2",
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png",
        "width": 1024,
        "height": 1024,
        "sizeBytes": 1048576,
        "imageDimensionsToken": "image_dimensions_token_from_original_files_api_upload_response"
      }
    ]
  }
}

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

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

{
  "id": "task_topaz_image_upscale_example",
  "status": "queued",
  "model": "topaz-image-upscale",
  "reserved_credits": 40,
  "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-তে রেফারেন্স আপলোড করতে হয়।

Topaz Image Upscaler API ইন্টিগ্রেশন