Rivya Public API v1 দিয়ে Ideogram V3 ব্যবহার করুন: model id ideogram-v3, supported inputs, parameters, Files API rules, credits এবং response examples সহ।

Available via APIটেক্সট ইনপুট প্রস্তুতছবি

API model id

ideogram-v3

Inputs

text

Files API

minimal request-এর জন্য required নয়

Base credits

Capability

ছবি

Billing

FIXED

প্রম্পট সীমা

5000 characters

Request contract

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

Key	Type	Required	Default	বিবরণ
model	string	Yes	ideogram-v3	ideogram-v3 API model id ব্যবহার করুন।
prompt	string	Yes	-	এই model-এর জন্য maximum 5000 characters।
params	object	No	-	Model-specific parameter object। allowed keys-এর জন্য নিচের rows ব্যবহার করুন।
client_request_id	string	No	-	আপনার system-এ requests trace করার optional client-side id।

Model parameters

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

Minimal 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 return করে। task succeeds বা fails না করা পর্যন্ত 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
}

Common errors

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found