Langkau ke kandungan

Ideogram Replace Background

Integrasikan

ID model 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"

Permintaan ini: $0.06 60 kredit API Jalankan pada halaman ini

Dapatkan kunci API
Ideogram · Imej

Hasil pertama anda akan muncul di sini

Bina permintaan di bawah dan jalankannya dengan kunci API anda. Output disalin ke storan kami, disimpan selama-lamanya atau 7 hari secara percuma.

Bina permintaan

Kawalan dijana daripada skema model. Kod dan harga dikemas kini apabila anda mengubahnya.

•diperlukan

Prompt teks, contohnya bandar cyberpunk dengan bangunan pencakar langit yang diterangi neon.

•diperlukan image_url
Lepaskan fail, atau

URL yang menunjuk kepada imej yang memerlukan penggantian latar belakang.

rendering_speed lalai BALANCED

Tetapan kelajuan untuk pemaparan.

num_images lalai 1

Bilangan imej yang hendak dihasilkan.

Lanjutan images · style · style_preset · seed · expand_prompt · style_codes · color_palette
image_urls
Lepaskan fail, atau

Imej rujukan gaya dalam format JPEG, PNG atau WebP. Saiz gabungannya tidak boleh melebihi 10 MB.

style

Jenis gaya yang digunakan untuk penjanaan; tidak boleh digunakan bersama style_codes.

Praset gaya yang pemilihannya membimbing penjanaan imej.

Nilai seed untuk penjanaan nombor rawak.

Kod gaya imej, dibekalkan sebagai rentetan heksadesimal 8 aksara setiap satu; jangan sertakan style_reference_images dan style apabila menggunakan senarai ini.

Palet warna yang digunakan semasa penjanaan. Nyatakan pratetap melalui name atau warna heksadesimal secara jelas melalui members, dengan berat pilihan.

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

Jalankan permintaan ini

Kunci anda kekal dalam pelayar ini: ia hanya dihantar kepada Doitong API dan disimpan (localStorage) hanya jika anda menanda Ingat. Dapatkan kunci API

Tentang Ideogram Replace Background

Menggantikan latar belakang imej (`image_url`) berdasarkan `prompt` teks yang menerangkan adegan baharu. Rujukan gaya, `style_codes`, `color_palette`, `style` dan `style_preset` boleh membimbing rupa. Kelajuan pemaparan ialah TURBO, BALANCED atau QUALITY, dan 1 hingga 8 imej boleh dikembalikan.

Parameter

Hantar sama ada nama kanonik atau nama natif, bukan kedua-duanya. Nama kanonik

NamaJenis LalaiDibenarkan Penerangan
image_urlspilihan images
Jenisurl[] · image
Imej rujukan gaya dalam format JPEG, PNG atau WebP. Saiz gabungannya tidak boleh melebihi 10 MB.
rendering_speedpilihan
Jenisenum
LalaiBALANCED
TURBOBALANCEDQUALITY
Tetapan kelajuan untuk pemaparan.
color_palettepilihan
Jenisobject
Palet warna yang digunakan semasa penjanaan. Nyatakan pratetap melalui name atau warna heksadesimal secara jelas melalui members, dengan berat pilihan.
color_palette.memberspilihan
Jenisobject[]
Senarai ahli palet yang menentukan warna palet.
color_palette.members[].rgbdiperlukan
Jenisobject
Warna ahli palet yang dinyatakan sebagai RGB.
color_palette.members[].color_weightpilihan
Jenisnumber | null
Lalai0.5
0.05 – 1
Berat yang diberikan kepada warna ini dalam palet.
color_palette.namepilihan
Jenisenum
EMBERFRESHJUNGLEMAGICMELONMOSAICPASTELULTRAMARINE
Pilihan pratetap untuk palet warna.
style_codespilihan
Jenisstring[]
Kod gaya imej, dibekalkan sebagai rentetan heksadesimal 8 aksara setiap satu; jangan sertakan style_reference_images dan style apabila menggunakan senarai ini.
stylepilihan
Jenisenum
AUTOGENERALREALISTICDESIGN
Jenis gaya yang digunakan untuk penjanaan; tidak boleh digunakan bersama style_codes.
expand_promptpilihan
Jenisboolean
Lalaitrue
Suis penggunaan MagicPrompt untuk penjanaan permintaan.
num_imagespilihan num_outputs
Jenisinteger
Lalai1
1 – 8
Bilangan imej yang hendak dihasilkan.
seedpilihan
Jenisinteger | null
Nilai seed untuk penjanaan nombor rawak.
style_presetpilihan
Jenisenum
80S_ILLUSTRATION90S_NOSTALGIAABSTRACT_ORGANICANALOG_NOSTALGIAART_BRUTART_DECOART_POSTERAURAAVANT_GARDEBAUHAUSBLUEPRINTBLURRY_MOTIONBRIGHT_ARTC4D_CARTOONCHILDRENS_BOOKCOLLAGE
+46 lagiCOLORING_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
Praset gaya yang pemilihannya membimbing penjanaan imej.
promptdiperlukan
Jenisstring
Prompt teks, contohnya bandar cyberpunk dengan bangunan pencakar langit yang diterangi neon.
image_urldiperlukan image
Jenisurl · image
URL yang menunjuk kepada imej yang memerlukan penggantian latar belakang.
diperlukan Nama kanonik, turut diterima

Parameter fail menerima URL awam https://, URI data: sehingga 10 MB, atau file_url bagi muat naik. Fail

Output

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"
  }
}
Fail anda, pilihan andaSetiap outputs[].url ialah salinan pada storan kami: disimpan selama-lamanya (dibayar setiap GB-bulan) atau 7 hari secara percuma, mengikut tetapan akaun anda atau ?storage=.
Bentuk yang sama pada setiap modeltype, url, content_type, width, height dan duration, untuk imej, video dan audio. output ialah objek hasil model itu sendiri.
Medan output
images
array of object {url, content_type, file_name, file_size}
seed
integerNilai seed yang digunakan untuk penjanaan nombor rawak.

Lebih banyak model: Penyuntingan Imej

Untuk ejen AI: halaman ini dalam Markdown tersedia di https://doitong.com/ms/developers/models/ideogram/v3/replace-background.md. Semua model dan panduan: https://doitong.com/developers/llms.txt