Přejít na obsah

Ideogram V3 Edit

Integrace

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

Tento požadavek: 0,06 $ 60 kreditů API Spustit na této stránce

Získat API klíč
Ideogram · Obrázek

Zde se zobrazí váš první výsledek

Níže sestavte požadavek a spusťte ho pomocí svého API klíče. Výstupy se kopírují do našeho úložiště a uchovávají se navždy nebo 7 dne zdarma.

Sestavit požadavek

Ovládací prvky se generují ze schématu modelu. Kód a cena se aktualizují podle provedených změn.

•povinné

Prompt popisující výplň maskované oblasti obrázku.

•povinné image_url
Přetáhněte soubor nebo

Zdroj pro generování zadaný jako URL obrázku, přičemž šířka i výška musí přesně odpovídat příslušným rozměrům masky.

•povinné mask_url
Přetáhněte soubor nebo

Maska inpaintingu zadaná pomocí URL, přičemž šířka i výška musí přesně odpovídat příslušným rozměrům vstupního obrázku.

rendering_speed výchozí BALANCED

Nastavení rychlosti vykreslování.

num_images výchozí 1

Počet obrázků, které se mají vytvořit.

Pokročilé images · style_preset · seed · expand_prompt · style_codes · color_palette
image_urls
Přetáhněte soubor nebo

Referenční obrázky stylu ve formátu JPEG, PNG nebo WebP. Jejich celková velikost nesmí překročit 10 MB.

Předvolba stylu, jejíž výběr řídí generování obrázku.

Hodnota seedu pro generování náhodných čísel.

Kódy stylu obrázku zadané jako hexadecimální řetězce dlouhé 8 znaků; při použití tohoto seznamu vynechte style_reference_images i style.

Paleta barev použitá během generování. Zadejte buď předvolbu pomocí name, nebo explicitní hexadecimální barvy pomocí members, volitelně včetně vah.

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"

Spustit tento požadavek

Váš klíč zůstává v tomto prohlížeči: odesílá se pouze do Doitong API a uloží se do localStorage jen tehdy, když zaškrtnete možnost Zapamatovat. Získat klíč API

O modelu Ideogram V3 Edit

Vyplní maskovanou oblast obrázku podle `prompt`. Obrázek (`image_url`) a maska (`mask_url`) musí mít stejné rozměry. Styl lze řídit referenčními obrázky, `style_codes`, `color_palette` nebo `style_preset`. Rychlost vykreslování je TURBO, BALANCED nebo QUALITY a lze vrátit 1 až 8 obrázků.

Parametry

Odešlete buď kanonický název, nebo nativní název, ne oba. Kanonické názvy

NázevTyp VýchozíPovolené Popis
image_urlsvolitelné images
Typurl[] · image
Referenční obrázky stylu ve formátu JPEG, PNG nebo WebP. Jejich celková velikost nesmí překročit 10 MB.
rendering_speedvolitelné
Typenum
VýchozíBALANCED
TURBOBALANCEDQUALITY
Nastavení rychlosti vykreslování.
color_palettevolitelné
Typobject
Paleta barev použitá během generování. Zadejte buď předvolbu pomocí name, nebo explicitní hexadecimální barvy pomocí members, volitelně včetně vah.
color_palette.membersvolitelné
Typobject[]
Seznam položek palety určující její barvy.
color_palette.members[].rgbpovinné
Typobject
Barva položky palety vyjádřená jako RGB.
color_palette.members[].color_weightvolitelné
Typnumber | null
Výchozí0.5
0,05 – 1
Váha přiřazená této barvě v paletě.
color_palette.namevolitelné
Typenum
EMBERFRESHJUNGLEMAGICMELONMOSAICPASTELULTRAMARINE
Výběr předvolby palety barev.
style_codesvolitelné
Typstring[]
Kódy stylu obrázku zadané jako hexadecimální řetězce dlouhé 8 znaků; při použití tohoto seznamu vynechte style_reference_images i style.
expand_promptvolitelné
Typboolean
Výchozítrue
Přepínač použití MagicPrompt pro vytvoření požadavku.
num_imagesvolitelné num_outputs
Typinteger
Výchozí1
1 – 8
Počet obrázků, které se mají vytvořit.
seedvolitelné
Typinteger | null
Hodnota seedu pro generování náhodných čísel.
style_presetvolitelné
Typenum
80S_ILLUSTRATION90S_NOSTALGIAABSTRACT_ORGANICANALOG_NOSTALGIAART_BRUTART_DECOART_POSTERAURAAVANT_GARDEBAUHAUSBLUEPRINTBLURRY_MOTIONBRIGHT_ARTC4D_CARTOONCHILDRENS_BOOKCOLLAGE
+46 dalšíchCOLORING_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
Předvolba stylu, jejíž výběr řídí generování obrázku.
promptpovinné
Typstring
Prompt popisující výplň maskované oblasti obrázku.
image_urlpovinné image
Typurl · image
Zdroj pro generování zadaný jako URL obrázku, přičemž šířka i výška musí přesně odpovídat příslušným rozměrům masky.
mask_urlpovinné mask
Typurl · image
Maska inpaintingu zadaná pomocí URL, přičemž šířka i výška musí přesně odpovídat příslušným rozměrům vstupního obrázku.
povinné Kanonický název, také podporován

Parametry souborů přijímají veřejnou adresu https:// URL, data: URI do 10 MB nebo file_url nahraného souboru. Soubory

Výstup

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 soubory, vaše volbaKaždý outputs[].url je kopie v našem úložišti: uchovávaná navždy (zpoplatněná za GB-měsíc) nebo 7 dne zdarma podle nastavení účtu nebo ?storage=.
Stejná struktura u každého modelutype, url, content_type, width, height a duration pro obrázky, video i zvuk. output je vlastní objekt výsledku modelu.
Pole výstupu
images
array of object {url, content_type, file_name, file_size}
seed
integerHodnota seedu použitá pro generování náhodných čísel.

Další modely: Úprava obrázků

Pro AI agenty: tato stránka je ve formátu Markdown na adrese https://doitong.com/cs/developers/models/ideogram/v3/edit.md. Všechny modely a návody: https://doitong.com/developers/llms.txt