Pāriet uz saturu

Ideogram Replace Background

Integrēt

Modeļa id 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"

Šis pieprasījums: 0,06 $ 60 API kredītu Izpildīt šajā lapā

Iegūt API atslēgu
Ideogram · Attēls

Šeit būs jūsu pirmais rezultāts

Izveidojiet pieprasījumu tālāk un izpildiet to ar savu API atslēgu. Izvades tiek kopētas mūsu krātuvē un glabātas mūžīgi vai 7 dienas bez maksas.

Izveidot pieprasījumu

Vadīklas tiek ģenerētas no modeļa shēmas. Kods un cena tiek atjaunināti, kad tos maināt.

•obligāts

Teksta uzvedne, piemēram, kiberpanka pilsēta ar neona apgaismotiem debesskrāpjiem.

•obligāts image_url
Nometiet failu vai

URL, kas norāda uz attēlu, kuram jāaizstāj fons.

rendering_speed noklusējums BALANCED

Renderēšanas ātruma iestatījums.

num_images noklusējums 1

Ģenerējamo attēlu skaits.

Papildu images · style · style_preset · seed · expand_prompt · style_codes · color_palette
image_urls
Nometiet failu vai

Stila atsauces attēli JPEG, PNG vai WebP formātā. To kopējais izmērs nedrīkst pārsniegt 10 MB.

style

Ģenerēšanai izmantotais stila tips; tas nav savienojams ar style_codes.

Stila sākotne, kuras izvēle vada attēla ģenerēšanu.

Nejaušo skaitļu ģenerēšanas sēklas vērtība.

Attēla stila kodi, kas sniegti kā 8 rakstzīmju heksadecimālas virknes; izmantojot šo sarakstu, neiekļaujiet ne style_reference_images, ne style.

Ģenerēšanas laikā izmantotā krāsu palete. Norādiet iepriekšiestatījumu, izmantojot name, vai precīzas heksadecimālās krāsas, izmantojot members; pēc izvēles var iekļaut svarus.

POST /run/ideogram/v3/replace-background?wait=20 cena → 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"

Palaist šo pieprasījumu

Jūsu atslēga paliek šajā pārlūkprogrammā: tā tiek nosūtīta tikai uz Doitong API un saglabāta (localStorage) tikai tad, ja atzīmējat Atcerēties. Iegūt API atslēgu

Par Ideogram Replace Background

Aizstāj attēla (`image_url`) fonu, pamatojoties uz teksta `prompt`, kas apraksta jauno ainu. Izskatu var vadīt ar stila atsaucēm, `style_codes`, `color_palette`, `style` un `style_preset`. Renderēšanas ātrums ir TURBO, BALANCED vai QUALITY, un var atgriezt 1 līdz 8 attēlus.

Parametri

Nosūti vai nu kanonisko nosaukumu, vai vietējo nosaukumu, bet ne abus. Kan啤niskie nosaukumi

NosaukumsTips NoklusējumsAtļauts Apraksts
image_urlsneobligāts images
Tipsurl[] · image
Stila atsauces attēli JPEG, PNG vai WebP formātā. To kopējais izmērs nedrīkst pārsniegt 10 MB.
rendering_speedneobligāts
Tipsenum
NoklusējumsBALANCED
TURBOBALANCEDQUALITY
Renderēšanas ātruma iestatījums.
color_paletteneobligāts
Tipsobject
Ģenerēšanas laikā izmantotā krāsu palete. Norādiet iepriekšiestatījumu, izmantojot name, vai precīzas heksadecimālās krāsas, izmantojot members; pēc izvēles var iekļaut svarus.
color_palette.membersneobligāts
Tipsobject[]
Paletes elementu saraksts, kas definē paletes krāsas.
color_palette.members[].rgbobligāts
Tipsobject
Paletes elementa krāsa, izteikta RGB formātā.
color_palette.members[].color_weightneobligāts
Tipsnumber | null
Noklusējums0.5
0,05 – 1
Šai krāsai paletē piešķirtais svars.
color_palette.nameneobligāts
Tipsenum
EMBERFRESHJUNGLEMAGICMELONMOSAICPASTELULTRAMARINE
Krāsu paletes iepriekšiestatījuma izvēle.
style_codesneobligāts
Tipsstring[]
Attēla stila kodi, kas sniegti kā 8 rakstzīmju heksadecimālas virknes; izmantojot šo sarakstu, neiekļaujiet ne style_reference_images, ne style.
styleneobligāts
Tipsenum
AUTOGENERALREALISTICDESIGN
Ģenerēšanai izmantotais stila tips; tas nav savienojams ar style_codes.
expand_promptneobligāts
Tipsboolean
Noklusējumstrue
MagicPrompt lietojuma pārslēgs pieprasījumu ģenerēšanai.
num_imagesneobligāts num_outputs
Tipsinteger
Noklusējums1
1 – 8
Ģenerējamo attēlu skaits.
seedneobligāts
Tipsinteger | null
Nejaušo skaitļu ģenerēšanas sēklas vērtība.
style_presetneobligāts
Tipsenum
80S_ILLUSTRATION90S_NOSTALGIAABSTRACT_ORGANICANALOG_NOSTALGIAART_BRUTART_DECOART_POSTERAURAAVANT_GARDEBAUHAUSBLUEPRINTBLURRY_MOTIONBRIGHT_ARTC4D_CARTOONCHILDRENS_BOOKCOLLAGE
+vēl 46COLORING_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
Stila sākotne, kuras izvēle vada attēla ģenerēšanu.
promptobligāts
Tipsstring
Teksta uzvedne, piemēram, kiberpanka pilsēta ar neona apgaismotiem debesskrāpjiem.
image_urlobligāts image
Tipsurl · image
URL, kas norāda uz attēlu, kuram jāaizstāj fons.
obligāts Kan啤niskais nosaukums, arī pieņemts

Failu parametriem nepieciešams publisks https:// URL, data: URI līdz 10 MB vai augšupielādes file_url. Faili

Izvade

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"
  }
}
Jūsu faili, jūsu izvēleKatrs outputs[].url ir kopija mūsu krātuvē: tiek glabāta mūžīgi (maksa par GB mēnesī) vai 7 dienas bez maksas — atbilstoši konta iestatījumam vai ?storage=.
Vienāda struktūra katram modelimtype, url, content_type, width, height un duration gan attēliem, gan video un audio. output ir paša modeļa rezultāta objekts.
Izvades lauki
images
array of object {url, content_type, file_name, file_size}
seed
integerNejaušo skaitļu ģenerēšanai izmantotā sēklas vērtība.

Vairāk modeļu: Attēlu rediģēšana

AI aģentiem: šī lapa Markdown formātā ir pieejama https://doitong.com/lv/developers/models/ideogram/v3/replace-background.md. Visi modeļi un ceļveži: https://doitong.com/developers/llms.txt