Saltar al cuntegna

Ideogram V3 Edit

Integrar

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

Questa dumonda: $0,06 60 credits API Lantschar sin questa pagina

Obtegna ina clav API
Ideogram · Maletg

Tes emprim resultat vegn qua

Construis ina dumonda sutvart e l'exequescha cun tia clav API. Outputs vegnan copiads en nossa memorisaziun, conservads per adina u 7 dis gratuitamain.

Construir ina dumonda

Ils controls vegnan generads dal schema dal model. Il code e ​​il pretsch s'actualiseschan durant che ti als midas.

•obligatori

Prompt che descriva l'empleniment per la regiun mascrada dal maletg.

•obligatori image_url
Trametta in datoteca u

Funtauna da generaziun furnida sco URL dal maletg; tant la ladezza sco l'autezza ston correspunder exactamain a las dimensiuns correspundentas da la mascra.

•obligatori mask_url
Trametta in datoteca u

Mascra d'inpainting furnida tras URL; tant la ladezza sco l'autezza ston correspunder exactamain a las dimensiuns correspundentas dal maletg d'input.

rendering_speed standard BALANCED

Configuraziun da la sveltezza per il rendering.

num_images standard 1

Dumber da maletgs da producir.

Avanzà images · style_preset · seed · expand_prompt · style_codes · color_palette
image_urls
Trametta in datoteca u

Maletgs da referenza dal stil en format JPEG, PNG u WebP. La grondezza cuminaida na dastga betg surpassar 10 MB.

Preset da stil che diriger la generaziun dal maletg.

Valur dal seme per la generaziun da nums casuals.

Codes dal stil dal maletg, furnids sco strings hexadecimalas da 8 caracters mintgamai; ometta tant style_reference_images sco style cun questa glista.

Paletta da colurs utilisada durant la generaziun. Inditgescha u in preset tras name u colurs hexadecimalas explicitas tras members, eventualmain cun pais.

POST /run/ideogram/v3/edit?wait=20 calculaziun → $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"

Executar questa dumonda

Tia clav resta en quest browser: ella vegn tramessa mo al Doitong API e memorisada (localStorage) mo sch'ella scheccas Tiar a memoria. Obtegnair ina clav API

Davart Ideogram V3 Edit

Emplenescha ina zona mascrada d’in maletg tenor in `prompt`. Il maletg (`image_url`) e la mascrina (`mask_url`) ston avair las medemas dimensiuns. Il stil po vegnir dirigì cun maletgs da referenza, `style_codes`, ina `color_palette` u in `style_preset`. La sveltezza è TURBO, BALANCED u QUALITY, e pon vegnir returnads 1 fin 8 maletgs.

Parameters

Invia u il num canonic u il num nativ, betg omaduas. Nums canonics

NumTip StandardPermess Descripziun
image_urlsopziunal images
Tipurl[] · image
Maletgs da referenza dal stil en format JPEG, PNG u WebP. La grondezza cuminaida na dastga betg surpassar 10 MB.
rendering_speedopziunal
Tipenum
StandardBALANCED
TURBOBALANCEDQUALITY
Configuraziun da la sveltezza per il rendering.
color_paletteopziunal
Tipobject
Paletta da colurs utilisada durant la generaziun. Inditgescha u in preset tras name u colurs hexadecimalas explicitas tras members, eventualmain cun pais.
color_palette.membersopziunal
Tipobject[]
Glista dals members da la paletta che definescha las colurs da la paletta.
color_palette.members[].rgbobligatori
Tipobject
Colur dal member da la paletta exprimida sco RGB.
color_palette.members[].color_weightopziunal
Tipnumber | null
Standard0.5
0,05 – 1
Pais assegnà a questa colur entaifer la paletta.
color_palette.nameopziunal
Tipenum
EMBERFRESHJUNGLEMAGICMELONMOSAICPASTELULTRAMARINE
Selecziun dal preset per la paletta da colurs.
style_codesopziunal
Tipstring[]
Codes dal stil dal maletg, furnids sco strings hexadecimalas da 8 caracters mintgamai; ometta tant style_reference_images sco style cun questa glista.
expand_promptopziunal
Tipboolean
Standardtrue
Activa u deactiva l'utilisaziun da MagicPrompt per la generaziun da la dumonda.
num_imagesopziunal num_outputs
Tipinteger
Standard1
1 – 8
Dumber da maletgs da producir.
seedopziunal
Tipinteger | null
Valur dal seme per la generaziun da nums casuals.
style_presetopziunal
Tipenum
80S_ILLUSTRATION90S_NOSTALGIAABSTRACT_ORGANICANALOG_NOSTALGIAART_BRUTART_DECOART_POSTERAURAAVANT_GARDEBAUHAUSBLUEPRINTBLURRY_MOTIONBRIGHT_ARTC4D_CARTOONCHILDRENS_BOOKCOLLAGE
+46 dapliCOLORING_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 da stil che diriger la generaziun dal maletg.
promptobligatori
Tipstring
Prompt che descriva l'empleniment per la regiun mascrada dal maletg.
image_urlobligatori image
Tipurl · image
Funtauna da generaziun furnida sco URL dal maletg; tant la ladezza sco l'autezza ston correspunder exactamain a las dimensiuns correspundentas da la mascra.
mask_urlobligatori mask
Tipurl · image
Mascra d'inpainting furnida tras URL; tant la ladezza sco l'autezza ston correspunder exactamain a las dimensiuns correspundentas dal maletg d'input.
obligatori Num canonic, er acceptà

Ils parameters da datotecas acceptan ina URL publica https://, ina URI data: fin a 10 MB u il file_url d'ina chargiada. Datotecas

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"
  }
}
Tias datotecas, tia decisiunMintga outputs[].url è ina copia en nossa memorisaziun: conservada per adina (pajà per GB-mes) u 7 dis gratuitamain, tenor la configuraziun dal conto u ?storage=.
La medema structura per mintga modeltype, url, content_type, width, height e duration, tant per maletgs sco per video e audio. output è l'object da resultat dal model sez.
Champs da l'output
images
array of object {url, content_type, file_name, file_size}
seed
integerValur dal seme utilisada per la generaziun da nums casuals.

Dapli models: Modificaziun da maletgs

Per agents AI: questa pagina sco Markdown è disponibla sut https://doitong.com/rm/developers/models/ideogram/v3/edit.md. Tut ils models e las guidas: https://doitong.com/developers/llms.txt