Preskoči na vsebino

Ideogram V3 Edit

Integracija

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

Ta zahteva: 0,06 $ 60 API kreditov Zaženi na tej strani

Pridobi ključ API
Ideogram · Slika

Tukaj bo vaš prvi rezultat

Spodaj sestavite zahtevo in jo zaženite s svojim ključem API. Izhodi se kopirajo v našo shrambo, kjer se hranijo za vedno ali 7 dni brezplačno.

Ustvari zahtevo

Kontrolniki se ustvarijo iz sheme modela. Koda in cena se posodobita, ko ju spreminjate.

•obvezno

Poziv, ki opisuje zapolnitev maskiranega območja slike.

•obvezno image_url
Spustite datoteko ali

Vir generiranja, podan kot URL slike; širina in višina se morata natančno ujemati z ustreznima merama maske.

•obvezno mask_url
Spustite datoteko ali

Maska za vrisovanje, podana prek URL-ja; širina in višina se morata natančno ujemati z ustreznima merama vhodne slike.

rendering_speed privzeto BALANCED

Nastavitev hitrosti upodabljanja.

num_images privzeto 1

Število slik za ustvarjanje.

Napredno images · style_preset · seed · expand_prompt · style_codes · color_palette
image_urls
Spustite datoteko ali

Referenčne slike sloga v obliki JPEG, PNG ali WebP. Njihova skupna velikost ne sme presegati 10 MB.

Prednastavitev sloga, katere izbira usmerja generiranje slike.

Vrednost semena za generiranje naključnih števil.

Kode sloga slike, podane kot šestnajstiški nizi po 8 znakov; pri uporabi tega seznama izpustite style_reference_images in style.

Barvna paleta, uporabljena pri generiranju. Določite prednastavitev prek name ali izrecne šestnajstiške barve prek members, po želji z utežmi.

POST /run/ideogram/v3/edit?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/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"

Zaženi to zahtevo

Vaš ključ ostane v tem brskalniku: pošlje se samo v Doitong API in shrani v localStorage samo, če označite možnost Zapomni si. Pridobi ključ API

O modelu Ideogram V3 Edit

Zapolni maskirano območje slike glede na `prompt`. Slika (`image_url`) in maska (`mask_url`) morata imeti enake mere. Slog je mogoče usmerjati z referenčnimi slikami, `style_codes`, `color_palette` ali `style_preset`. Hitrost izrisovanja je TURBO, BALANCED ali QUALITY, vrniti pa je mogoče od 1 do 8 slik.

Parametri

Pošlji kanonično ali izvorno ime, ne obeh. Kanonična imena

ImeVrsta PrivzetoDovoljeno Opis
image_urlsneobvezno images
Vrstaurl[] · image
Referenčne slike sloga v obliki JPEG, PNG ali WebP. Njihova skupna velikost ne sme presegati 10 MB.
rendering_speedneobvezno
Vrstaenum
PrivzetoBALANCED
TURBOBALANCEDQUALITY
Nastavitev hitrosti upodabljanja.
color_paletteneobvezno
Vrstaobject
Barvna paleta, uporabljena pri generiranju. Določite prednastavitev prek name ali izrecne šestnajstiške barve prek members, po želji z utežmi.
color_palette.membersneobvezno
Vrstaobject[]
Seznam članov palete, ki določa njene barve.
color_palette.members[].rgbobvezno
Vrstaobject
Barva člana palete, izražena kot RGB.
color_palette.members[].color_weightneobvezno
Vrstanumber | null
Privzeto0.5
0,05 – 1
Utež, dodeljena tej barvi v paleti.
color_palette.nameneobvezno
Vrstaenum
EMBERFRESHJUNGLEMAGICMELONMOSAICPASTELULTRAMARINE
Izbira prednastavitve barvne palete.
style_codesneobvezno
Vrstastring[]
Kode sloga slike, podane kot šestnajstiški nizi po 8 znakov; pri uporabi tega seznama izpustite style_reference_images in style.
expand_promptneobvezno
Vrstaboolean
Privzetotrue
Preklop uporabe MagicPrompt pri ustvarjanju zahteve.
num_imagesneobvezno num_outputs
Vrstainteger
Privzeto1
1 – 8
Število slik za ustvarjanje.
seedneobvezno
Vrstainteger | null
Vrednost semena za generiranje naključnih števil.
style_presetneobvezno
Vrstaenum
80S_ILLUSTRATION90S_NOSTALGIAABSTRACT_ORGANICANALOG_NOSTALGIAART_BRUTART_DECOART_POSTERAURAAVANT_GARDEBAUHAUSBLUEPRINTBLURRY_MOTIONBRIGHT_ARTC4D_CARTOONCHILDRENS_BOOKCOLLAGE
+46 večCOLORING_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
Prednastavitev sloga, katere izbira usmerja generiranje slike.
promptobvezno
Vrstastring
Poziv, ki opisuje zapolnitev maskiranega območja slike.
image_urlobvezno image
Vrstaurl · image
Vir generiranja, podan kot URL slike; širina in višina se morata natančno ujemati z ustreznima merama maske.
mask_urlobvezno mask
Vrstaurl · image
Maska za vrisovanje, podana prek URL-ja; širina in višina se morata natančno ujemati z ustreznima merama vhodne slike.
obvezno Kanonično ime, prav tako sprejeto

Parametri datotek sprejmejo javni https:// URL, podatkovni URI data: do 10 MB ali file_url naložene datoteke. Datoteke

Izhod

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"
  }
}
Vaše datoteke, vaša izbiraVsak outputs[].url je kopija v naši shrambi: hrani se za vedno (plačilo na GB-mesec) ali 7 dni brezplačno, glede na nastavitev računa ali ?storage=.
Enaka struktura pri vsakem modelutype, url, content_type, width, height in duration za slike, videoposnetke in zvok. output je lasten objekt rezultata modela.
Polja izhoda
images
array of object {url, content_type, file_name, file_size}
seed
integerVrednost semena za generiranje naključnih števil.

Več modelov: Urejanje slik

Za agente AI: ta stran je v obliki Markdown na voljo na https://doitong.com/sl/developers/models/ideogram/v3/edit.md. Vsi modeli in vodniki: https://doitong.com/developers/llms.txt