Rivya Public API v1 দিয়ে Ideogram Character ব্যবহার করুন: মডেল আইডি ideogram-character, সমর্থিত ইনপুট, প্যারামিটার, Files API-র নিয়ম, ক্রেডিট ও উত্তরের উদাহরণসহ।

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

API মডেল আইডি

ideogram-character

ইনপুট

file

Files API

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

বেস ক্রেডিট

per_image · TURBO=12 · BALANCED=18 · QUALITY=24 · ⌈total⌉

ক্ষমতা

ছবি

বিলিং

FIXED

প্রম্পট সীমা

5000 অক্ষর

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

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

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

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

কী	ধরন	প্রয়োজনীয়	ডিফল্ট	পরিসর	বিকল্প	বিবরণ
rendering_speed	select	না	BALANCED	-	TURBO, BALANCED, QUALITY	speed, cost এবং detail-এর ভারসাম্য রাখে। Turbo fastest এবং cheapest, Quality most detailed এবং most expensive, আর Balanced default middle ground।
style	select	না	AUTO	-	AUTO, REALISTIC, FICTION	Style
expand_prompt	select	না	true	-	true, false	Ideogram-এর prompt expansion switch। এটি on করলে model আপনার description flesh out করতে সাহায্য করে; tight prompt control চাইলে off রাখা ভালো।
image_size	select	না	square_hd	-	square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9	Image size
num_images	select	না	1	-	1, 2, 3, 4	1–4টি আউটপুট বেছে নিন। মোট খরচ প্রতি ছবির দামকে নির্বাচিত সংখ্যায় গুণ করে পূর্ণ ক্রেডিটে ঊর্ধ্বমুখী রাউন্ড করা হয়।
seed	number	না	-	-	-	প্রতিবার নতুন random result চাইলে empty রাখুন। একই integer reuse করলে আগের result reproduce বা fine-tune করা সহজ হয়। Prompt এবং অন্য key setting একই রকম থাকলেই শুধু result কাছাকাছি থাকে, এবং এটি guaranteed 1:1 match নয়।
negative_prompt	text	না	-	-	-	Negative prompt

আপলোড নীতি

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

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

Character reference image: এই project-এর জন্য ঠিক 1টি image file upload করুন।

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

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

image

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

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

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

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

{
  "model": "ideogram-character",
  "params": {
    "rendering_speed": "BALANCED",
    "style": "AUTO",
    "expand_prompt": "true",
    "image_size": "square_hd",
    "num_images": "1",
    "seed": 1,
    "negative_prompt": "এড়াতে চান এমন optional content"
  }
}

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

{
  "model": "ideogram-character",
  "params": {
    "rendering_speed": "BALANCED",
    "style": "AUTO",
    "expand_prompt": "true",
    "image_size": "square_hd",
    "num_images": "1",
    "seed": 1,
    "negative_prompt": "এড়াতে চান এমন optional content",
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png"
      }
    ]
  }
}

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

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

{
  "id": "task_ideogram_character_example",
  "status": "queued",
  "model": "ideogram-character",
  "reserved_credits": 18,
  "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-তে রেফারেন্স আপলোড করতে হয়।

Ideogram Character API ইন্টিগ্রেশন