Ideogram V3 کو Rivya Public API v1 کے ذریعے ماڈل ID ideogram-v3، معاون اِن پٹس، پیرامیٹرز، Files API قواعد، کریڈٹس اور جواب کی مثالوں کے ساتھ استعمال کریں۔

API کے ذریعے دستیابمتنی اِن پٹ تیارتصویر

API ماڈل ID

ideogram-v3

اِن پٹس

text

Files API

کم سے کم درخواست کے لیے ضروری نہیں

بنیادی کریڈٹس

per_image · TURBO=3.5 · BALANCED=7 · QUALITY=10 · ⌈total⌉

صلاحیت

تصویر

بلنگ

FIXED

پرامپٹ کی حد

5000 حروف

درخواست کا معاہدہ

`model` ID کو بالائی سطح پر بھیجیں۔ ماڈل کے مخصوص کنٹرولز `params` میں رہتے ہیں۔

کلید	قسم	ضروری	طے شدہ	وضاحت
model	string	ہاں	ideogram-v3	API ماڈل ID کے طور پر ideogram-v3 استعمال کریں۔
prompt	string	ہاں	-	اس ماڈل کے لیے زیادہ سے زیادہ 5000 حروف۔
params	object	نہیں	-	ماڈل کا مخصوص پیرامیٹر آبجیکٹ۔ اجازت یافتہ کلیدوں کے لیے نیچے والی قطاریں دیکھیں۔
client_request_id	string	نہیں	-	اپنے نظام میں درخواستوں کا سراغ رکھنے کے لیے اختیاری صارف طرفہ ID۔

ماڈل پیرامیٹرز

کلید	قسم	ضروری	طے شدہ	حد	اختیارات	وضاحت
rendering_speed	select	نہیں	BALANCED	-	TURBO, BALANCED, QUALITY	Speed، cost، اور detail کو balance کرتا ہے۔ Turbo سب سے تیز اور cheapest ہے، Quality سب سے 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	نہیں	-	-	-	ہر بار نیا بے ترتیب نتیجہ چاہیے ہو تو اسے خالی چھوڑیں۔ اسی عدد صحیح کو دوبارہ استعمال کرنے سے پچھلا نتیجہ دوبارہ بنانا یا باریک بہتر کرنا آسان ہوتا ہے۔ نتیجہ صرف اسی وقت زیادہ قریب رہتا ہے جب پرامپٹ اور دیگر اہم ترتیبات بھی ملتی جلتی رہیں، اور یہ 1:1 مماثلت کی ضمانت نہیں۔
negative_prompt	text	نہیں	-	-	-	Negative prompt

کم سے کم درخواست

{
  "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": 1,
    "negative_prompt": "Avoid کرنے کے لئے optional things"
  }
}

تخلیقی جواب

تخلیقی اینڈ پوائنٹ عوامی کام کی ID واپس کرتا ہے۔ کام کے کامیاب یا ناکام ہونے تک حالت والے اینڈ پوائنٹ سے جانچتے رہیں۔

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

Ideogram V3 API انضمام

درخواست کا معاہدہ

ماڈل پیرامیٹرز

کم سے کم درخواست

تخلیقی جواب

عام خرابیاں

متعلقہ API دستاویزات