Langkau ke kandungan

Ideogram V3 Edit

Integrasikan

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

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 yang menerangkan fill untuk kawasan bertopeng imej.

•diperlukan image_url
Lepaskan fail, atau

Sumber penjanaan yang dibekalkan sebagai URL imej, dengan lebar dan tinggi kedua-duanya mesti sama tepat dengan dimensi sepadan topeng.

•diperlukan mask_url
Lepaskan fail, atau

Topeng inpainting yang dibekalkan melalui URL, dengan lebar dan tinggi kedua-duanya mesti sama tepat dengan dimensi sepadan imej input.

rendering_speed lalai BALANCED

Tetapan kelajuan untuk pemaparan.

num_images lalai 1

Bilangan imej yang hendak dihasilkan.

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

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/edit?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/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"

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 V3 Edit

Mengisi kawasan bermask pada imej mengikut `prompt`. Imej (`image_url`) dan topeng (`mask_url`) mesti mempunyai dimensi yang sama. Gaya boleh dipandu dengan imej rujukan, `style_codes`, `color_palette` atau `style_preset`. 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.
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 yang menerangkan fill untuk kawasan bertopeng imej.
image_urldiperlukan image
Jenisurl · image
Sumber penjanaan yang dibekalkan sebagai URL imej, dengan lebar dan tinggi kedua-duanya mesti sama tepat dengan dimensi sepadan topeng.
mask_urldiperlukan mask
Jenisurl · image
Topeng inpainting yang dibekalkan melalui URL, dengan lebar dan tinggi kedua-duanya mesti sama tepat dengan dimensi sepadan imej input.
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/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"
  }
}
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/edit.md. Semua model dan panduan: https://doitong.com/developers/llms.txt