مواد پر جائیں

Ideogram V3 Edit

انٹیگریٹ کریں

ماڈل id ideogram/v3/edit
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/ideogram/v3/edit?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "mask": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

یہ درخواست: ⁨$0.06⁩ 60 API کریڈٹس اس صفحے پر چلائیں

API کلید حاصل کریں
Ideogram · تصویر

آپ کا پہلا نتیجہ یہاں آئے گا

ذیل میں درخواست بنائیں اور اپنی API کلید کے ساتھ چلائیں۔ آؤٹ پٹس ہمارے اسٹوریج میں کاپی ہو جاتے ہیں، ہمیشہ کے لیے یا مفت میں 7 دن تک محفوظ رہتے ہیں۔

درخواست بنائیں

کنٹرولز ماڈل اسکیما سے تیار ہوتے ہیں۔ آپ کے بدلنے کے ساتھ کوڈ اور قیمت اپ ڈیٹ ہوتے ہیں۔

•لازمی

تصویر کے masked region کے fill کی وضاحت کرنے والا پرامپٹ۔

•لازمی image_url
فائل ڈراپ کریں، یا

تصویر کے URL کے طور پر فراہم کردہ تخلیقی source؛ width اور height دونوں کا mask کے متعلقہ dimensions کے عین برابر ہونا ضروری ہے۔

•لازمی mask_url
فائل ڈراپ کریں، یا

URL کے ذریعے فراہم کردہ inpainting mask؛ width اور height دونوں کا ان پٹ تصویر کے متعلقہ dimensions کے عین برابر ہونا ضروری ہے۔

rendering_speed ڈیفالٹ BALANCED

rendering کے لیے speed setting۔

num_images ڈیفالٹ 1

تیار کی جانے والی تصاویر کی تعداد۔

ایڈوانسڈ images · style_preset · seed · expand_prompt · style_codes · color_palette
image_urls
فائل ڈراپ کریں، یا

JPEG، PNG یا WebP format میں style reference تصاویر۔ ان کا مجموعی سائز 10 MB سے زیادہ نہیں ہونا چاہیے۔

وہ طرز پری سیٹ جس کا انتخاب تصویر کی تخلیق کی رہنمائی کرتا ہے۔

random number تخلیق کے لیے seed value۔

تصویری اسٹائل کے کوڈز، جو 8 حروف کی ہیکساڈیسیمل سٹرنگز کے طور پر فراہم کیے جاتے ہیں؛ یہ فہرست استعمال کرتے وقت style_reference_images اور style دونوں کو شامل نہ کریں۔

تخلیق کے دوران استعمال ہونے والا color palette۔ name کے ذریعے preset یا members کے ذریعے واضح hexadecimal colors، اختیاری weights کے ساتھ، بیان کریں۔

POST /run/ideogram/v3/edit?wait=20 قیمت → ⁨$0.06⁩
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/ideogram/v3/edit?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "mask": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

یہ درخواست چلائیں

آپ کی key اسی براؤزر میں رہتی ہے: یہ صرف Doitong API کو بھیجی جاتی ہے اور صرف اس صورت میں localStorage میں محفوظ ہوتی ہے جب آپ Remember منتخب کریں۔ API کلید حاصل کریں

Ideogram V3 Edit کے بارے میں

`prompt` کے مطابق امیج کے ماسک شدہ حصے کو بھرتا ہے۔ امیج (`image_url`) اور ماسک (`mask_url`) کے ابعاد یکساں ہونے چاہئیں۔ ریفرنس امیجز، `style_codes`، `color_palette` یا `style_preset` سے اسٹائل کی رہنمائی کی جا سکتی ہے۔ رینڈرنگ رفتار TURBO، BALANCED یا QUALITY ہے، اور 1 سے 8 تصاویر واپس کی جا سکتی ہیں۔

پیرامیٹرز

معیاری نام یا مقامی نام میں سے صرف ایک بھیجیں، دونوں نہیں۔ معیاری نام

نامقسم ڈیفالٹمجاز تفصیل
image_urlsاختیاری images
قسمurl[] · image
JPEG، PNG یا WebP format میں style reference تصاویر۔ ان کا مجموعی سائز 10 MB سے زیادہ نہیں ہونا چاہیے۔
rendering_speedاختیاری
قسمenum
ڈیفالٹBALANCED
TURBOBALANCEDQUALITY
rendering کے لیے speed setting۔
color_paletteاختیاری
قسمobject
تخلیق کے دوران استعمال ہونے والا color palette۔ name کے ذریعے preset یا members کے ذریعے واضح hexadecimal colors، اختیاری weights کے ساتھ، بیان کریں۔
color_palette.membersاختیاری
قسمobject[]
Palette member list، جو palette کے colors متعین کرتی ہے۔
color_palette.members[].rgbلازمی
قسمobject
Palette member کا color، RGB کے طور پر ظاہر کیا گیا ہے۔
color_palette.members[].color_weightاختیاری
قسمnumber | null
ڈیفالٹ0.5
0.05 – 1
Palette میں اس color کو دیا گیا weight۔
color_palette.nameاختیاری
قسمenum
EMBERFRESHJUNGLEMAGICMELONMOSAICPASTELULTRAMARINE
Color palette کے لیے preset selection۔
style_codesاختیاری
قسمstring[]
تصویری اسٹائل کے کوڈز، جو 8 حروف کی ہیکساڈیسیمل سٹرنگز کے طور پر فراہم کیے جاتے ہیں؛ یہ فہرست استعمال کرتے وقت style_reference_images اور style دونوں کو شامل نہ کریں۔
expand_promptاختیاری
قسمboolean
ڈیفالٹtrue
درخواست تخلیق کے لیے MagicPrompt استعمال toggle۔
num_imagesاختیاری num_outputs
قسمinteger
ڈیفالٹ1
1 – 8
تیار کی جانے والی تصاویر کی تعداد۔
seedاختیاری
قسمinteger | null
random number تخلیق کے لیے seed value۔
style_presetاختیاری
قسمenum
80S_ILLUSTRATION90S_NOSTALGIAABSTRACT_ORGANICANALOG_NOSTALGIAART_BRUTART_DECOART_POSTERAURAAVANT_GARDEBAUHAUSBLUEPRINTBLURRY_MOTIONBRIGHT_ARTC4D_CARTOONCHILDRENS_BOOKCOLLAGE
+46 مزیدCOLORING_BOOK_ICOLORING_BOOK_IICUBISMDARK_AURADOODLEDOUBLE_EXPOSUREDRAMATIC_CINEMAEDITORIALEMOTIONAL_MINIMALETHEREAL_PARTYEXPIRED_FILMFLAT_ARTFLAT_VECTORFOREST_REVERIEGEO_MINIMALISTGLASS_PRISMGOLDEN_HOURGRAFFITI_IGRAFFITI_IIHALFTONE_PRINTHIGH_CONTRASTHIPPIE_ERAICONICJAPANDI_FUSIONJAZZYLONG_EXPOSUREMAGAZINE_EDITORIALMINIMAL_ILLUSTRATIONMIXED_MEDIAMONOCHROMENIGHTLIFEOIL_PAINTINGOLD_CARTOONSPAINT_GESTUREPOP_ARTRETRO_ETCHINGRIVIERA_POPSPOTLIGHT_80SSTYLIZED_REDSURREAL_COLLAGETRAVEL_POSTERVINTAGE_GEOVINTAGE_POSTERWATERCOLORWEIRDWOODBLOCK_PRINT
وہ طرز پری سیٹ جس کا انتخاب تصویر کی تخلیق کی رہنمائی کرتا ہے۔
promptلازمی
قسمstring
تصویر کے masked region کے fill کی وضاحت کرنے والا پرامپٹ۔
image_urlلازمی image
قسمurl · image
تصویر کے URL کے طور پر فراہم کردہ تخلیقی source؛ width اور height دونوں کا mask کے متعلقہ dimensions کے عین برابر ہونا ضروری ہے۔
mask_urlلازمی mask
قسمurl · image
URL کے ذریعے فراہم کردہ inpainting mask؛ width اور height دونوں کا ان پٹ تصویر کے متعلقہ dimensions کے عین برابر ہونا ضروری ہے۔
لازمی معیاری نام، یہ بھی قبول ہے

فائل پیرامیٹرز عوامی https:// URL، 10 MB تک کی data: URI، یا اپ لوڈ کے file_url کو قبول کرتے ہیں۔ فائلیں

آؤٹ پٹ

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "ideogram/v3/edit",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 60,
    "usd": "0.06",
    "charged": 60,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "mask_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "output": {
    "images": [
      {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      }
    ],
    "seed": 42
  },
  "outputs": [
    {
      "type": "image",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "width": 1024,
      "height": 768,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
آپ کی فائلیں، آپ کا انتخابہر outputs[].url ہمارے اسٹوریج میں ایک کاپی ہے: ہمیشہ کے لیے محفوظ (فی GB-ماہ ادائیگی) یا مفت میں 7 دن تک، آپ کی اکاؤنٹ سیٹنگ یا ?storage= کے مطابق۔
ہر ماڈل میں ایک جیسی ساختtype، url، content_type، width، height اور duration، تصاویر، ویڈیو اور آڈیو سب کے لیے یکساں۔ output ماڈل کا اپنا نتیجہ آبجیکٹ ہے۔
آؤٹ پٹ کے فیلڈز
images
array of object {url, content_type, file_name, file_size}
seed
integerrandom number تخلیق کے لیے استعمال ہونے والی seed value۔

مزید ماڈلز: تصویر میں ترمیم

AI ایجنٹس کے لیے: یہ صفحہ Markdown میں یہاں موجود ہے https://doitong.com/ur/developers/models/ideogram/v3/edit.md. تمام ماڈلز اور گائیڈز: https://doitong.com/developers/llms.txt