Peke ki ngā ihirangi

Ideogram Replace Background

Whakauru

id tauira ideogram/v3/replace-background
# 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/replace-background?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"
  }'

# 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 kuputuhi, hei tauira, he tāone cyberpunk me ngā pourewa ā-rohe e whiti ana i te neon.

•e hiahiatia ana image_url
Whakataka he kōnae,

URL e tohu ana ki te atahanga e hiahia ana ki te whakakapi papamuri.

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 · 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.

style

Momo kāhua e whakamahia ana mō te whakaputanga; kāore e taea te whakamahi tahi me style_codes.

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/replace-background?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/replace-background?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"
  }'

# 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 Replace Background

Ka whakakapi i te papamuri o tētahi whakaahua (`image_url`) i runga i tētahi `prompt` kuputuhi e whakaahua ana i te tirohanga hou. Ka taea e ngā tohutoro kāhua, `style_codes`, `color_palette`, `style` me `style_preset` te ārahi i te āhua. 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.
stylekōwhiringa
Momoenum
AUTOGENERALREALISTICDESIGN
Momo kāhua e whakamahia ana mō te whakaputanga; kāore e taea te whakamahi tahi me style_codes.
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 kuputuhi, hei tauira, he tāone cyberpunk me ngā pourewa ā-rohe e whiti ana i te neon.
image_urle hiahiatia ana image
Momourl · image
URL e tohu ana ki te atahanga e hiahia ana ki te whakakapi papamuri.
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/replace-background",
  "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"
  },
  "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/replace-background.md. Ngā tauira me ngā aratohu katoa: https://doitong.com/developers/llms.txt