အကြောင်းအရာသို့ ကျော်ရန်

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"

ဤတောင်းဆိုချက်: ၀.၁၅ $ ၁၅၀ API ခရက်ဒစ် · ≈ ၁၅.၈၂ ₽ ဤစာမျက်နှာတွင် လုပ်ဆောင်ရန်

API ကီး ရယူရန်
Ideogram ပုံတည်းဖြတ်ခြင်း ရည်ညွှန်း ထည့်သွင်းချက်များ #character-consistency

ရည်ညွှန်းထားသော ဇာတ်ကောင်၏ ကိုယ်ပိုင်လက္ခဏာကို ထိန်းထားကာ ပုံတစ်ပုံကို Ideogram V3 မတ်စ်ဖြင့် တည်းဖြတ်ခြင်း

Ideogram · ပုံ

သင့်ပထမဆုံးရလဒ် ဤနေရာတွင် ပေါ်လာမည်

အောက်တွင် တောင်းဆိုချက်တစ်ခု တည်ဆောက်ပြီး သင့် API ကီးဖြင့် လုပ်ဆောင်ပါ။ ထွက်ရလဒ်များကို ကျွန်ုပ်တို့၏ သိုလှောင်မှုသို့ ကူးယူပြီး အမြဲတမ်း သို့မဟုတ် ၇ ရက် အခမဲ့ သိမ်းထားသည်။

တောင်းဆိုမှုတစ်ခု တည်ဆောက်ရန်

ထိန်းချုပ်မှုများကို မော်ဒယ် schema မှ အလိုအလျောက်ဖန်တီးသည်။ ၎င်းတို့ကို ပြောင်းလဲသည်နှင့် code နှင့် စျေးနှုန်းတို့လည်း ပြောင်းလဲမည်။

•လိုအပ်သည်

ပုံ၏ mask လုပ်ထားသော ဧရိယာတွင် ဖြည့်သွင်းမည့်အရာကို ဖော်ပြသည့် ပရောမ့်။

•လိုအပ်သည် image_url
ဖိုင်ကို ဆွဲချပါ၊ သို့မဟုတ်

ပုံ URL အဖြစ် ပေးထားသည့် ဖန်တီးမှုရင်းမြစ်။ အကျယ်နှင့် အမြင့် နှစ်ခုစလုံးသည် mask ၏ သက်ဆိုင်ရာ အတိုင်းအတာများနှင့် တိတိကျကျ တူညီရမည်။

•လိုအပ်သည် mask_url
ဖိုင်ကို ဆွဲချပါ၊ သို့မဟုတ်

URL ဖြင့် ပေးထားသည့် Inpainting mask။ အကျယ်နှင့် အမြင့် နှစ်ခုစလုံးသည် ထည့်သွင်းပုံ၏ သက်ဆိုင်ရာ အတိုင်းအတာများနှင့် တိတိကျကျ တူညီရမည်။

•လိုအပ်သည်
ဖိုင်ကို ဆွဲချပါ၊ သို့မဟုတ်

JPEG၊ PNG သို့မဟုတ် WebP ဖော်မတ်ရှိ ဇာတ်ကောင်ရည်ညွှန်းပုံများ။ ဇာတ်ကောင်ရည်ညွှန်းချက်အားလုံး၏ စုစုပေါင်းကန့်သတ်ချက်မှာ 10 MB ဖြစ်သည်။ လက်ရှိတွင် ပုံ 1 ပုံသာ ပံ့ပိုးပြီး ထပ်ဆောင်းပုံများကို လျစ်လျူရှုမည်။

rendering_speed မူလ BALANCED

Render ပြုလုပ်ရန် အမြန်နှုန်း သတ်မှတ်ချက်။

num_images မူလ 1

ထုတ်လုပ်မည့် ပုံအရေအတွက်။

အဆင့်မြင့် images · reference_mask_urls · seed · expand_prompt · style_codes · color_palette
image_urls
ဖိုင်ကို ဆွဲချပါ၊ သို့မဟုတ်

JPEG၊ PNG သို့မဟုတ် WebP ဖော်မတ်ရှိ စတိုင်ရည်ညွှန်းပုံများ။ စုစုပေါင်းအရွယ်အစားသည် 10 MB ထက် မကျော်ရပါ။

ဖိုင်ကို ဆွဲချပါ၊ သို့မဟုတ်

JPEG၊ PNG သို့မဟုတ် WebP ဖော်မတ်ရှိ ဇာတ်ကောင်ရည်ညွှန်း mask များ။ ဇာတ်ကောင်ရည်ညွှန်းချက်အားလုံး၏ စုစုပေါင်းအရွယ်အစားသည် 10 MB ထက် မကျော်ရပါ။ လက်ရှိတွင် mask 1 ခုသာ အသုံးပြုပြီး ထပ်ဆောင်း mask များကို လျစ်လျူရှုမည်။

ကျပန်းနံပါတ် ဖန်တီးမှုအတွက် seed တန်ဖိုး။

တစ်ခုစီတွင် အက္ခရာ 8 လုံးပါသော hexadecimal string များအဖြစ် ပေးထားသည့် ပုံစတိုင်ကုဒ်များ။ ဤစာရင်းကို အသုံးပြုသည့်အခါ style_reference_images နှင့် style နှစ်ခုစလုံးကို ချန်လှပ်ပါ။

ဖန်တီးစဉ် အသုံးပြုမည့် အရောင် palette။ name မှတစ်ဆင့် ကြိုတင်သတ်မှတ်ချက်တစ်ခု သို့မဟုတ် members မှတစ်ဆင့် hexadecimal အရောင်များကို အလေးချိန်များဖြင့်ဖြစ်စေ မပါဘဲဖြစ်စေ သတ်မှတ်ပါ။

POST /run/ideogram/character/edit?wait=20 ကုန်ကျစရိတ် → ၀.၁၅ $
# 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 သို့သာ ပို့မည်။ Remember ကို အမှန်ခြစ်ထားမှသာ (localStorage) တွင် သိမ်းမည်။ API ကီး ရယူရန်

Ideogram V3 Character Edit အကြောင်း

`mask_url` (နှစ်ခုစလုံး အရွယ်အစားတူရမည်)၊ `prompt` နှင့် `reference_image_urls` ရှိ ဇာတ်ကောင်ရည်ညွှန်းချက် (ပုံ 1 ပုံအသုံးပြုသည်) ကို အသုံးပြု၍ `image_url` ၏ မတ်စ်ထားသောဧရိယာကို အင်ပိန်းတင်း ပြုလုပ်သည်။ ကိုယ်ဟန်၊ မျက်နှာအမူအရာ သို့မဟုတ် အဝတ်အစား ပြောင်းရန် အသုံးဝင်သည်။ ရွေးချယ်နိုင်သော စတိုင်ရည်ညွှန်းချက်များ၊ `rendering_speed` နှင့် ထွက်ရလဒ် 8 ခုအထိ ပါဝင်သည်။

ပါရာမီတာများ

စံအမည် သို့မဟုတ် မူရင်းအမည် တစ်ခုခုကိုသာ ပို့ပါ၊ နှစ်ခုလုံး မပို့ပါနှင့်။ စံအမည်များ

အမည်အမျိုးအစား မူလတန်ဖိုးခွင့်ပြုထားသည် ဖော်ပြချက်
image_urlsရွေးချယ်နိုင်သည် images
အမျိုးအစားurl[] · image
JPEG၊ PNG သို့မဟုတ် WebP ဖော်မတ်ရှိ စတိုင်ရည်ညွှန်းပုံများ။ စုစုပေါင်းအရွယ်အစားသည် 10 MB ထက် မကျော်ရပါ။
rendering_speedရွေးချယ်နိုင်သည်
အမျိုးအစားenum
မူလတန်ဖိုးBALANCED
TURBOBALANCEDQUALITY
Render ပြုလုပ်ရန် အမြန်နှုန်း သတ်မှတ်ချက်။
color_paletteရွေးချယ်နိုင်သည်
အမျိုးအစားobject
ဖန်တီးစဉ် အသုံးပြုမည့် အရောင် palette။ name မှတစ်ဆင့် ကြိုတင်သတ်မှတ်ချက်တစ်ခု သို့မဟုတ် members မှတစ်ဆင့် hexadecimal အရောင်များကို အလေးချိန်များဖြင့်ဖြစ်စေ မပါဘဲဖြစ်စေ သတ်မှတ်ပါ။
color_palette.membersရွေးချယ်နိုင်သည်
အမျိုးအစားobject[]
Palette ၏ အရောင်များကို သတ်မှတ်သည့် palette member စာရင်း။
color_palette.members[].rgbလိုအပ်သည်
အမျိုးအစားobject
RGB ဖြင့် ဖော်ပြထားသော palette member ၏ အရောင်။
color_palette.members[].color_weightရွေးချယ်နိုင်သည်
အမျိုးအစားnumber | null
မူလတန်ဖိုး0.5
၀.၀၅ – ၁
Palette အတွင်း ဤအရောင်အတွက် သတ်မှတ်ထားသော အလေးချိန်။
color_palette.nameရွေးချယ်နိုင်သည်
အမျိုးအစားenum
EMBERFRESHJUNGLEMAGICMELONMOSAICPASTELULTRAMARINE
အရောင် palette အတွက် ကြိုတင်သတ်မှတ်ချက် ရွေးချယ်မှု။
style_codesရွေးချယ်နိုင်သည်
အမျိုးအစားstring[]
တစ်ခုစီတွင် အက္ခရာ 8 လုံးပါသော hexadecimal string များအဖြစ် ပေးထားသည့် ပုံစတိုင်ကုဒ်များ။ ဤစာရင်းကို အသုံးပြုသည့်အခါ style_reference_images နှင့် style နှစ်ခုစလုံးကို ချန်လှပ်ပါ။
expand_promptရွေးချယ်နိုင်သည်
အမျိုးအစားboolean
မူလတန်ဖိုးtrue
တောင်းဆိုချက် ဖန်တီးမှုအတွက် MagicPrompt အသုံးပြုမှု ခလုတ်။
num_imagesရွေးချယ်နိုင်သည် num_outputs
အမျိုးအစားinteger
မူလတန်ဖိုး1
၁ – ၈
ထုတ်လုပ်မည့် ပုံအရေအတွက်။
seedရွေးချယ်နိုင်သည်
အမျိုးအစားinteger | null
ကျပန်းနံပါတ် ဖန်တီးမှုအတွက် seed တန်ဖိုး။
promptလိုအပ်သည်
အမျိုးအစားstring
ပုံ၏ mask လုပ်ထားသော ဧရိယာတွင် ဖြည့်သွင်းမည့်အရာကို ဖော်ပြသည့် ပရောမ့်။
image_urlလိုအပ်သည် image
အမျိုးအစားurl · image
ပုံ URL အဖြစ် ပေးထားသည့် ဖန်တီးမှုရင်းမြစ်။ အကျယ်နှင့် အမြင့် နှစ်ခုစလုံးသည် mask ၏ သက်ဆိုင်ရာ အတိုင်းအတာများနှင့် တိတိကျကျ တူညီရမည်။
mask_urlလိုအပ်သည် mask
အမျိုးအစားurl · image
URL ဖြင့် ပေးထားသည့် Inpainting mask။ အကျယ်နှင့် အမြင့် နှစ်ခုစလုံးသည် ထည့်သွင်းပုံ၏ သက်ဆိုင်ရာ အတိုင်းအတာများနှင့် တိတိကျကျ တူညီရမည်။
reference_image_urlsလိုအပ်သည်
အမျိုးအစားurl[] · image
JPEG၊ PNG သို့မဟုတ် WebP ဖော်မတ်ရှိ ဇာတ်ကောင်ရည်ညွှန်းပုံများ။ ဇာတ်ကောင်ရည်ညွှန်းချက်အားလုံး၏ စုစုပေါင်းကန့်သတ်ချက်မှာ 10 MB ဖြစ်သည်။ လက်ရှိတွင် ပုံ 1 ပုံသာ ပံ့ပိုးပြီး ထပ်ဆောင်းပုံများကို လျစ်လျူရှုမည်။
reference_mask_urlsရွေးချယ်နိုင်သည်
အမျိုးအစားurl[] · image
JPEG၊ PNG သို့မဟုတ် WebP ဖော်မတ်ရှိ ဇာတ်ကောင်ရည်ညွှန်း mask များ။ ဇာတ်ကောင်ရည်ညွှန်းချက်အားလုံး၏ စုစုပေါင်းအရွယ်အစားသည် 10 MB ထက် မကျော်ရပါ။ လက်ရှိတွင် mask 1 ခုသာ အသုံးပြုပြီး ထပ်ဆောင်း mask များကို လျစ်လျူရှုမည်။
လိုအပ်သည် စံအမည်၊ ထို့အပြင် လက်ခံသည်

ဖိုင်ပါရာမီတာများသည် အများပြည်သူသုံး 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-month အလိုက် ငွေပေးရသည်) သို့မဟုတ် ၇ ရက် အခမဲ့၊ သင့်အကောင့်ဆက်တင် သို့မဟုတ် ?storage= ဖြင့် သိမ်းထားသည်။
မော်ဒယ်တိုင်းတွင် ပုံစံတူပုံ၊ ဗီဒီယိုနှင့် အသံတို့အတွက် type၊ url၊ content_type၊ width၊ height နှင့် duration။ output သည် မော်ဒယ်ကိုယ်တိုင်၏ ရလဒ် object ဖြစ်သည်။
ထွက်ရလဒ်၏ Fields များ
images
array of object {url, content_type, file_name, file_size}
seed
integerကျပန်းနံပါတ် ဖန်တီးမှုအတွက် အသုံးပြုသည့် seed တန်ဖိုး။

နောက်ထပ် မော်ဒယ်များ: ပုံတည်းဖြတ်ခြင်း

AI အေးဂျင့်များအတွက်- ဤစာမျက်နှာ၏ Markdown ကို ဤနေရာတွင် ရရှိနိုင်သည် https://doitong.com/my/developers/models/ideogram/character/edit.md. မော်ဒယ်များနှင့် လမ်းညွှန်များအားလုံး: https://doitong.com/developers/llms.txt