مواد پر جائیں

Ideogram V3 Character Edit

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

ماڈل id ideogram/character/edit
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/ideogram/character/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",
    "reference_image_urls": [
      "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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

یہ درخواست: ⁨$0.15⁩ 150 API کریڈٹس · ≈ ⁨₽15.82⁩ اس صفحے پر چلائیں

API کلید حاصل کریں
Ideogram تصویر میں ترمیم حوالہ جاتی ان پٹس #character-consistency

Ideogram V3 کی ماسک پر مبنی ایڈیٹنگ، جس میں ریفرنس کردہ کردار کی شناخت برقرار رہتی ہے

Ideogram · تصویر

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

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

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

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

•لازمی

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

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

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

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

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

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

JPEG، PNG یا WebP format میں character reference تصاویر؛ تمام character references کا مجموعی limit 10 MB ہے۔ فی الحال صرف 1 تصویر support ہے؛ اضافی تصاویر نظر انداز کی جاتی ہیں۔

rendering_speed ڈیفالٹ BALANCED

rendering کے لیے speed setting۔

num_images ڈیفالٹ 1

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

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

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

فائل ڈراپ کریں، یا

JPEG، PNG یا WebP format میں character-reference masks؛ تمام character references کا مجموعی سائز 10 MB سے زیادہ نہیں ہو سکتا۔ فی الحال صرف 1 mask استعمال ہوتا ہے، اضافی masks نظر انداز کیے جاتے ہیں۔

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

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

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

POST /run/ideogram/character/edit?wait=20 قیمت → ⁨$0.15⁩
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/ideogram/character/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",
    "reference_image_urls": [
      "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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

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

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

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

`mask_url` کے ذریعے `image_url` کے ماسک شدہ حصے کو ان پینٹ کرتا ہے (دونوں کے ابعاد یکساں ہونے چاہئیں)، ساتھ میں `prompt` اور `reference_image_urls` میں کردار کا ریفرنس درکار ہے (1 امیج استعمال ہوتی ہے)۔ پوز، تاثرات یا لباس تبدیل کرنے کے لیے مفید ہے۔ اختیاری اسٹائل ریفرنسز، `rendering_speed` اور زیادہ سے زیادہ 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۔
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 کے عین برابر ہونا ضروری ہے۔
reference_image_urlsلازمی
قسمurl[] · image
JPEG، PNG یا WebP format میں character reference تصاویر؛ تمام character references کا مجموعی limit 10 MB ہے۔ فی الحال صرف 1 تصویر support ہے؛ اضافی تصاویر نظر انداز کی جاتی ہیں۔
reference_mask_urlsاختیاری
قسمurl[] · image
JPEG، PNG یا WebP format میں character-reference masks؛ تمام character references کا مجموعی سائز 10 MB سے زیادہ نہیں ہو سکتا۔ فی الحال صرف 1 mask استعمال ہوتا ہے، اضافی masks نظر انداز کیے جاتے ہیں۔
لازمی معیاری نام، یہ بھی قبول ہے

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

آؤٹ پٹ

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "ideogram/character/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": 150,
    "usd": "0.15",
    "charged": 150,
    "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",
    "reference_image_urls": [
      "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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/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/character/edit.md. تمام ماڈلز اور گائیڈز: https://doitong.com/developers/llms.txt