Peke ki ngā ihirangi

Ideogram V3 Edit

Whakauru

id tauira 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"

Tēnei tono: $ 0.06 60 whiwhinga API Whakahaerehia ki tēnei whārangi

Tikina he kī API
Ideogram · Atahanga

Kei konei tō hua tuatahi

Hangaia he tono ki raro nei, ka whakahaere mā tō kī API. Ka tāruatia ngā putanga ki tō mātou rokiroki, ka puritia mō ake tonu atu, mō rānei 7 rā mō te kore utu.

Hangaia he tono

Ka hangaia ngā mana whakahaere mai i te aronuinga o te tauira. Ka whakahoungia te waehere me te utu ina whakarerekē koe.

•e hiahiatia ana

Tohutohu e whakaahua ana i te whakakī mō te rohe kanohi o te atahanga.

•e hiahiatia ana image_url
Whakataka he kōnae,

Pūtake whakaputanga kua tukuna hei URL atahanga, me ōrite pū te whānui me te teitei ki ngā rahinga hāngai o te kanohi.

•e hiahiatia ana mask_url
Whakataka he kōnae,

Kanohi inpainting kua tukuna mā te URL, me ōrite pū te whānui me te teitei ki ngā rahinga hāngai o te atahanga tāuru.

rendering_speed taunoa BALANCED

Tautuhinga tere mō te tāhuahua.

num_images taunoa 1

Te maha o ngā atahanga hei whakaputa.

Arā atu images · style_preset · seed · expand_prompt · style_codes · color_palette
image_urls
Whakataka he kōnae,

Ngā atahanga tohutoro kāhua ki te hōputu JPEG, PNG, WebP rānei. Kaua e neke ake i te 10 MB te rahi whakakotahi.

Tautuhinga kāhua e ārahi ana i te whakaputanga atahanga.

Uara kākano mō te whakaputa tau matapōkere.

Ngā waehere kāhua atahanga, ka tukuna hei aho hexadecimal e 8 ngā pūāhua ia mea; kaua e whakamahi i style_reference_images me style ina whakamahi i tēnei rārangi.

Papatae tae e whakamahia ana i te whakaputanga. Tautuhia he tatūkē mā te ingoa, he tae hexadecimal rānei mā ngā mema, ā, ka taea te whakauru taumahatanga.

POST /run/ideogram/v3/edit?wait=20 utu → $ 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"

Whakahaerehia tēnei tono

Ka noho tō kī ki tēnei pūtirotiro: ka tukuna ki te Doitong API anake, ā, ka tiakina ki te localStorage anake ina tohua e koe te Mahara. Tikina he kī API

Mō Ideogram V3 Edit

Ka whakakī i tētahi wāhi ārai o te whakaahua kia rite ki tētahi `prompt`. Me ōrite rawa ngā rahinga o te whakaahua (`image_url`) me te ārai (`mask_url`). Ka taea te ārahi i te kāhua mā ngā whakaahua tohutoro, `style_codes`, `color_palette`, `style_preset` rānei. Ko te tere tuku he TURBO, BALANCED, QUALITY rānei, ā, ka whakahokia 1 ki te 8 whakaahua.

Ngā tawhā

Tukuna te ingoa tōmua, te ingoa taketake rānei, kaua e rua. Ngā ingoa tōmua

IngoaMomo TaunoaE whakaaetia ana Whakamārama
image_urlskōwhiringa images
Momourl[] · image
Ngā atahanga tohutoro kāhua ki te hōputu JPEG, PNG, WebP rānei. Kaua e neke ake i te 10 MB te rahi whakakotahi.
rendering_speedkōwhiringa
Momoenum
TaunoaBALANCED
TURBOBALANCEDQUALITY
Tautuhinga tere mō te tāhuahua.
color_palettekōwhiringa
Momoobject
Papatae tae e whakamahia ana i te whakaputanga. Tautuhia he tatūkē mā te ingoa, he tae hexadecimal rānei mā ngā mema, ā, ka taea te whakauru taumahatanga.
color_palette.memberskōwhiringa
Momoobject[]
Rārangi mema papatae e tautuhi ana i ngā tae o te papatae.
color_palette.members[].rgbe hiahiatia ana
Momoobject
Tae o te mema papatae kua whakaaturia hei RGB.
color_palette.members[].color_weightkōwhiringa
Momonumber | null
Taunoa0.5
0.05 – 1
Taumaha kua tautapaina ki tēnei tae i roto i te papatae.
color_palette.namekōwhiringa
Momoenum
EMBERFRESHJUNGLEMAGICMELONMOSAICPASTELULTRAMARINE
Kōwhiringa tatūkē mō te papatae tae.
style_codeskōwhiringa
Momostring[]
Ngā waehere kāhua atahanga, ka tukuna hei aho hexadecimal e 8 ngā pūāhua ia mea; kaua e whakamahi i style_reference_images me style ina whakamahi i tēnei rārangi.
expand_promptkōwhiringa
Momoboolean
Taunoatrue
Takahuri whakamahinga MagicPrompt mō te whakaputa tono.
num_imageskōwhiringa num_outputs
Momointeger
Taunoa1
1 – 8
Te maha o ngā atahanga hei whakaputa.
seedkōwhiringa
Momointeger | null
Uara kākano mō te whakaputa tau matapōkere.
style_presetkōwhiringa
Momoenum
80S_ILLUSTRATION90S_NOSTALGIAABSTRACT_ORGANICANALOG_NOSTALGIAART_BRUTART_DECOART_POSTERAURAAVANT_GARDEBAUHAUSBLUEPRINTBLURRY_MOTIONBRIGHT_ARTC4D_CARTOONCHILDRENS_BOOKCOLLAGE
+46 anō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
Tautuhinga kāhua e ārahi ana i te whakaputanga atahanga.
prompte hiahiatia ana
Momostring
Tohutohu e whakaahua ana i te whakakī mō te rohe kanohi o te atahanga.
image_urle hiahiatia ana image
Momourl · image
Pūtake whakaputanga kua tukuna hei URL atahanga, me ōrite pū te whānui me te teitei ki ngā rahinga hāngai o te kanohi.
mask_urle hiahiatia ana mask
Momourl · image
Kanohi inpainting kua tukuna mā te URL, me ōrite pū te whānui me te teitei ki ngā rahinga hāngai o te atahanga tāuru.
e hiahiatia ana Ingoa tōmua, e whakaaetia ana hoki

Mō ngā tawhā kōnae, whakamahia he URL tūmatanui https://, he URI data: tae atu ki te 10 MB, he file_url rānei o tētahi tukuake. Ngā kōnae

Putanga

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"
  }
}
Ō kōnae, māu e whiriwhiriKo ia url o outputs[] he tārua kei tō mātou rokiroki: ka puritia mō ake tonu atu (ka utua ia GB-marama) mō rānei 7 rā mō te kore utu, e ai ki ngā tautuhinga o tō pūkete, ki te ?storage= rānei.
He ōrite te hanga ki ia tauiratype, url, content_type, width, height me duration, mō ngā pikitia, ataata me te oro. Ko output te ahanoa hua ake o te tauira.
Ngā āpure o te putanga
images
array of object {url, content_type, file_name, file_size}
seed
integerUara kākano e whakamahia ana mō te whakaputa tau matapōkere.

Ētahi atu tauira: Whakatika Atahanga

Mō ngā āpiha AI: kei te wātea tēnei whārangi hei Markdown ki https://doitong.com/mi/developers/models/ideogram/v3/edit.md. Ngā tauira me ngā aratohu katoa: https://doitong.com/developers/llms.txt