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

Ideogram V3 Character

ပေါင်းစည်းရန်

မော်ဒယ် id ideogram/character
# 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/character?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",
    "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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

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

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

ကိုးကားပုံကို အသုံးပြု၍ ဇာတ်ကောင်တစ်ဦး၏ တူညီမှုကို ထိန်းသိမ်းပေးသော Ideogram V3 ဖန်တီးမှု

Ideogram · ပုံ

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

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

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

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

•လိုအပ်သည်

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

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

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

rendering_speed မူလ BALANCED

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

image_size မူလ square_hd

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

num_images မူလ 1

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

အဆင့်မြင့် negative_prompt · images · reference_mask_urls · style · seed · expand_prompt · style_codes · color_palette
မူလ

မလိုလားသော ပုံအကြောင်းအရာကို သတ်မှတ်ပါ။ ဤ negative-prompt ဖော်ပြချက်များထက် အဓိကပရောမ့်၏ ဖော်ပြချက်များကို ဦးစားပေးမည်။

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

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

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

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

style မူလ AUTO

ဖန်တီးမှုအတွက် အသုံးပြုသည့် စတိုင်အမျိုးအစား။ style_codes နှင့် တစ်ပြိုင်နက် အသုံးမပြုနိုင်ပါ။

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

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

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

POST /run/ideogram/character?wait=20 ကုန်ကျစရိတ် → ၀.၁၅ $
# 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/character?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",
    "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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

ဤတောင်းဆိုချက်ကို လုပ်ဆောင်ရန်

သင့် key သည် ဤဘရောက်ဇာထဲတွင်သာ ရှိမည်ဖြစ်ပြီး Doitong API သို့သာ ပို့မည်။ Remember ကို အမှန်ခြစ်ထားမှသာ (localStorage) တွင် သိမ်းမည်။ API ကီး ရယူရန်

Ideogram V3 Character အကြောင်း

`prompt` နှင့် `reference_image_urls` ထဲရှိ ကိုးကားပုံ (ပုံ 1 ပုံသာ အသုံးပြုသည်) မှ ဇာတ်ကောင်ပုံများကို ဖန်တီးသည်။ ရွေးချယ်နိုင်သော စတိုင်ကိုးကားချက်များကို `image_urls` ထဲ ထည့်ပြီး `style_codes`, `color_palette` နှင့် `reference_mask_urls` တို့ဖြင့် ပိုမိုထိန်းချုပ်နိုင်သည်။ `rendering_speed` သည် TURBO, BALANCED သို့မဟုတ် QUALITY ဖြစ်ပြီး `num_images` သည် 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 နှစ်ခုစလုံးကို ချန်လှပ်ပါ။
styleရွေးချယ်နိုင်သည်
အမျိုးအစားenum
မူလတန်ဖိုးAUTO
AUTOREALISTICFICTION
ဖန်တီးမှုအတွက် အသုံးပြုသည့် စတိုင်အမျိုးအစား။ style_codes နှင့် တစ်ပြိုင်နက် အသုံးမပြုနိုင်ပါ။
expand_promptရွေးချယ်နိုင်သည်
အမျိုးအစားboolean
မူလတန်ဖိုးtrue
တောင်းဆိုချက် ဖန်တီးမှုအတွက် MagicPrompt အသုံးပြုမှု ခလုတ်။
num_imagesရွေးချယ်နိုင်သည် num_outputs
အမျိုးအစားinteger
မူလတန်ဖိုး1
၁ – ၈
ထုတ်လုပ်မည့် ပုံအရေအတွက်။
seedရွေးချယ်နိုင်သည်
အမျိုးအစားinteger | null
ကျပန်းနံပါတ် ဖန်တီးမှုအတွက် seed တန်ဖိုး။
promptလိုအပ်သည်
အမျိုးအစားstring
ပုံ၏ mask လုပ်ထားသော ဧရိယာတွင် ဖြည့်သွင်းမည့်အရာကို ဖော်ပြသည့် ပရောမ့်။
image_sizeရွေးချယ်နိုင်သည်
အမျိုးအစားobject
မူလတန်ဖိုးsquare_hd
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
ထွက်ရလဒ်ပုံအတွက် အသုံးပြုမည့် ရုပ်ထွက်အရည်အသွေး။
negative_promptရွေးချယ်နိုင်သည်
အမျိုးအစားstring
မူလတန်ဖိုး
မလိုလားသော ပုံအကြောင်းအရာကို သတ်မှတ်ပါ။ ဤ negative-prompt ဖော်ပြချက်များထက် အဓိကပရောမ့်၏ ဖော်ပြချက်များကို ဦးစားပေးမည်။
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",
  "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",
    "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.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/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.md. မော်ဒယ်များနှင့် လမ်းညွှန်များအားလုံး: https://doitong.com/developers/llms.txt