Vai al contenuto

Ideogram V3 Edit

Integra

ID del modello 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.ru/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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Questa richiesta: 0,06 $ 60 crediti API · ≈ 6,39 ₽ Esegui in questa pagina

Ottieni la chiave API
Ideogram · Immagine

Il tuo primo risultato apparirà qui

Crea una richiesta qui sotto ed eseguila con la tua chiave API. Gli output vengono copiati nella nostra archiviazione, conservati per sempre oppure 7 giorni gratuitamente.

Crea una richiesta

I controlli vengono generati dallo schema del modello. Il codice e il prezzo si aggiornano mentre li modifichi.

•obbligatorio

Prompt che descrive il riempimento della regione mascherata dell'immagine.

•obbligatorio image_url
Trascina un file oppure

Sorgente della generazione fornita come URL di un'immagine, con larghezza e altezza obbligatoriamente uguali alle dimensioni corrispondenti della maschera.

•obbligatorio mask_url
Trascina un file oppure

Maschera di inpainting fornita tramite URL, con larghezza e altezza obbligatoriamente uguali alle dimensioni corrispondenti dell'immagine di input.

rendering_speed predefinito BALANCED

Impostazione della velocità di rendering.

num_images predefinito 1

Numero di immagini da produrre.

Avanzate images · style_preset · seed · expand_prompt · style_codes · color_palette
image_urls
Trascina un file oppure

Immagini di riferimento dello stile in formato JPEG, PNG o WebP. La dimensione combinata non deve superare 10 MB.

Preset di stile la cui selezione guida la generazione dell'immagine.

Valore seed per la generazione di numeri casuali.

Codici dello stile dell'immagine, forniti come stringhe esadecimali di 8 caratteri ciascuna; non includere né style_reference_images né style quando usi questo elenco.

Tavolozza di colori usata durante la generazione. Specifica un preset tramite name oppure colori esadecimali espliciti tramite members, includendo facoltativamente i pesi.

POST /run/ideogram/v3/edit?wait=20 preventivo → 0,06 $
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Esegui questa richiesta

La tua chiave rimane in questo browser: viene inviata solo al Doitong API e salvata in localStorage solo se selezioni Ricorda. Ottieni una chiave API

Informazioni su Ideogram V3 Edit

Riempie un'area mascherata di un'immagine in base a un `prompt`. L'immagine (`image_url`) e la maschera (`mask_url`) devono avere dimensioni identiche. Lo stile può essere guidato con immagini di riferimento, `style_codes`, una `color_palette` o uno `style_preset`. La velocità di rendering è TURBO, BALANCED o QUALITY e possono essere restituite da 1 a 8 immagini.

Parametri

Invia il nome canonico oppure il nome nativo, non entrambi. Nomi canonici

NomeTipo PredefinitoConsentiti Descrizione
image_urlsfacoltativo images
Tipourl[] · image
Immagini di riferimento dello stile in formato JPEG, PNG o WebP. La dimensione combinata non deve superare 10 MB.
rendering_speedfacoltativo
Tipoenum
PredefinitoBALANCED
TURBOBALANCEDQUALITY
Impostazione della velocità di rendering.
color_palettefacoltativo
Tipoobject
Tavolozza di colori usata durante la generazione. Specifica un preset tramite name oppure colori esadecimali espliciti tramite members, includendo facoltativamente i pesi.
color_palette.membersfacoltativo
Tipoobject[]
Elenco dei membri della tavolozza che definisce i relativi colori.
color_palette.members[].rgbobbligatorio
Tipoobject
Colore del membro della tavolozza espresso come RGB.
color_palette.members[].color_weightfacoltativo
Tiponumber | null
Predefinito0.5
0,05 – 1
Peso assegnato a questo colore nella tavolozza.
color_palette.namefacoltativo
Tipoenum
EMBERFRESHJUNGLEMAGICMELONMOSAICPASTELULTRAMARINE
Selezione del preset per la tavolozza dei colori.
style_codesfacoltativo
Tipostring[]
Codici dello stile dell'immagine, forniti come stringhe esadecimali di 8 caratteri ciascuna; non includere né style_reference_images né style quando usi questo elenco.
expand_promptfacoltativo
Tipoboolean
Predefinitotrue
Interruttore per l'uso di MagicPrompt nella generazione della richiesta.
num_imagesfacoltativo num_outputs
Tipointeger
Predefinito1
1 – 8
Numero di immagini da produrre.
seedfacoltativo
Tipointeger | null
Valore seed per la generazione di numeri casuali.
style_presetfacoltativo
Tipoenum
80S_ILLUSTRATION90S_NOSTALGIAABSTRACT_ORGANICANALOG_NOSTALGIAART_BRUTART_DECOART_POSTERAURAAVANT_GARDEBAUHAUSBLUEPRINTBLURRY_MOTIONBRIGHT_ARTC4D_CARTOONCHILDRENS_BOOKCOLLAGE
+46 altriCOLORING_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
Preset di stile la cui selezione guida la generazione dell'immagine.
promptobbligatorio
Tipostring
Prompt che descrive il riempimento della regione mascherata dell'immagine.
image_urlobbligatorio image
Tipourl · image
Sorgente della generazione fornita come URL di un'immagine, con larghezza e altezza obbligatoriamente uguali alle dimensioni corrispondenti della maschera.
mask_urlobbligatorio mask
Tipourl · image
Maschera di inpainting fornita tramite URL, con larghezza e altezza obbligatoriamente uguali alle dimensioni corrispondenti dell'immagine di input.
obbligatorio Nome canonico, accettato anche

I parametri file accettano un URL pubblico https://, un URI data: fino a 10 MB oppure il file_url di un caricamento. File

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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
I tuoi file, la tua sceltaOgni outputs[].url è una copia nella nostra archiviazione: conservata per sempre (a pagamento per GB-mese) oppure 7 giorni gratuitamente, in base all'impostazione dell'account o a ?storage=.
Stessa struttura per ogni modellotype, url, content_type, width, height e duration, per immagini, video e audio. output è l'oggetto risultato del modello.
Campi dell'output
images
array of object {url, content_type, file_name, file_size}
seed
integerValore seed usato per la generazione di numeri casuali.

Altri modelli: Modifica immagini

Per gli agenti AI: questa pagina in Markdown è disponibile all'indirizzo https://doitong.com/it/developers/models/ideogram/v3/edit.md. Tutti i modelli e le guide: https://doitong.com/developers/llms.txt