Rivya Public API v1 দিয়ে Ideogram V3 ব্যবহার করুন: model id ideogram-v3, সমর্থিত ইনপুট, প্যারামিটার, Files API নিয়ম, ক্রেডিট এবং response উদাহরণসহ।

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

API model id

ideogram-v3

ইনপুট

text

Files API

minimal request-এর জন্য প্রয়োজন নেই

বেস ক্রেডিট

ক্ষমতা

ছবি

বিলিং

FIXED

প্রম্পট সীমা

5000 অক্ষর

রিকোয়েস্ট contract

model id top level-এ পাঠান। Model-specific control params-এ থাকবে।

Key	ধরন	প্রয়োজনীয়	ডিফল্ট	বিবরণ
model	string	হ্যাঁ	ideogram-v3	ideogram-v3 API model id ব্যবহার করুন।
prompt	string	হ্যাঁ	-	এই model-এর জন্য সর্বোচ্চ 5000 অক্ষর।
params	object	না	-	মডেল-নির্দিষ্ট প্যারামিটার object। অনুমোদিত key-এর জন্য নিচের row ব্যবহার করুন।
client_request_id	string	না	-	আপনার সিস্টেমে request trace করার ঐচ্ছিক client-side id।

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

Key	ধরন	প্রয়োজনীয়	ডিফল্ট	পরিসর	বিকল্প	বিবরণ
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, GENERAL, REALISTIC, DESIGN	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
seed	number	না	-	min 0	-	প্রতিবার নতুন random result চাইলে empty রাখুন। একই integer reuse করলে আগের result reproduce বা fine-tune করা সহজ হয়। Prompt এবং অন্য key setting একই রকম থাকলেই শুধু result কাছাকাছি থাকে, এবং এটি guaranteed 1:1 match নয়।
negative_prompt	text	না	-	-	-	Negative prompt

ন্যূনতম request

{
  "model": "ideogram-v3",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "rendering_speed": "BALANCED",
    "style": "AUTO",
    "expand_prompt": "true",
    "image_size": "square_hd",
    "seed": 0,
    "negative_prompt": "এড়াতে চান এমন optional বিষয়"
  }
}

Create response

create endpoint public task id ফেরত দেয়। task succeeded বা failed না হওয়া পর্যন্ত status endpoint poll করুন।

{
  "id": "task_ideogram_v3_example",
  "status": "queued",
  "model": "ideogram-v3",
  "reserved_credits": 7,
  "final_credits": 0,
  "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