Přejít na obsah

Ideogram V3 Character Edit

Integrace

ID modelu ideogram/character/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/character/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",
    "reference_image_urls": [
      "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,15 $ 150 kreditů API Spustit na této stránce

Získat API klíč
Ideogram Úprava obrázků Referenční vstupy #character-consistency

Maskované úpravy obrázku v Ideogram V3 se zachováním identity referenční postavy

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.

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

Referenční obrázky postavy ve formátu JPEG, PNG nebo WebP s celkovým limitem 10 MB pro všechny reference postavy. Podpora je aktuálně omezena na 1 obrázek; další obrázky se ignorují.

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 · reference_mask_urls · 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řetáhněte soubor nebo

Masky reference postavy ve formátu JPEG, PNG nebo WebP; celková velikost všech referencí postavy nesmí překročit 10 MB. Aktuálně se používá pouze 1 maska a další se ignorují.

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/character/edit?wait=20 cena → 0,15 $
# 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/character/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",
    "reference_image_urls": [
      "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 Character Edit

Doplňuje maskovanou oblast obrázku `image_url` pomocí `mask_url` (oba soubory musí mít stejné rozměry), `prompt` a reference postavy v `reference_image_urls` (použije se 1 obrázek). Hodí se ke změně pózy, výrazu nebo oblečení. Podporuje volitelné stylové reference, `rendering_speed` a až 8 výstupů.

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.
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.
reference_image_urlspovinné
Typurl[] · image
Referenční obrázky postavy ve formátu JPEG, PNG nebo WebP s celkovým limitem 10 MB pro všechny reference postavy. Podpora je aktuálně omezena na 1 obrázek; další obrázky se ignorují.
reference_mask_urlsvolitelné
Typurl[] · image
Masky reference postavy ve formátu JPEG, PNG nebo WebP; celková velikost všech referencí postavy nesmí překročit 10 MB. Aktuálně se používá pouze 1 maska a další se ignorují.
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/character/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": 150,
    "usd": "0.15",
    "charged": 150,
    "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",
    "reference_image_urls": [
      "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/character/edit.md. Všechny modely a návody: https://doitong.com/developers/llms.txt