Naar inhoud springen

Ideogram V3 Character Edit

Integreren

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

Deze request: $ 0,15 150 API-tegoed Op deze pagina uitvoeren

API-sleutel ophalen
Ideogram Afbeelding bewerken Referentie-inputs #character-consistency

Ideogram V3-bewerking met masker waarbij de identiteit van een gerefereerd personage behouden blijft

Ideogram · Afbeelding

Je eerste resultaat komt hier

Bouw hieronder een request en voer die uit met je API-sleutel. Uitvoer wordt naar onze opslag gekopieerd en voor altijd of 7 dagen gratis bewaard.

Een aanvraag samenstellen

Besturingselementen worden gegenereerd op basis van het modelschema. De code en de prijs worden bijgewerkt terwijl je ze wijzigt.

•verplicht

Prompt die de vulling voor het gemaskeerde gebied van de afbeelding beschrijft.

•verplicht image_url
Sleep een bestand hierheen of

Generatiebron opgegeven als afbeeldings-URL, waarbij zowel de breedte als de hoogte exact gelijk moeten zijn aan de overeenkomstige afmetingen van het masker.

•verplicht mask_url
Sleep een bestand hierheen of

Inpaintingmasker opgegeven via URL, waarbij zowel de breedte als de hoogte exact gelijk moeten zijn aan de overeenkomstige afmetingen van de invoerafbeelding.

•verplicht
Sleep een bestand hierheen of

Karakterreferentieafbeeldingen in JPEG-, PNG- of WebP-indeling, met een gezamenlijke limiet van 10 MB voor alle karakterreferenties. Momenteel wordt slechts 1 afbeelding ondersteund; extra afbeeldingen worden genegeerd.

rendering_speed standaard BALANCED

Snelheidsinstelling voor rendering.

num_images standaard 1

Aantal te produceren afbeeldingen.

Geavanceerd images · reference_mask_urls · seed · expand_prompt · style_codes · color_palette
image_urls
Sleep een bestand hierheen of

Stijlreferentieafbeeldingen in JPEG-, PNG- of WebP-indeling. De gecombineerde grootte mag niet groter zijn dan 10 MB.

Sleep een bestand hierheen of

Maskers voor karakterreferenties in JPEG-, PNG- of WebP-indeling; de totale grootte van alle karakterreferenties mag niet groter zijn dan 10 MB. Momenteel wordt slechts 1 masker gebruikt; extra maskers worden genegeerd.

Seedwaarde voor het genereren van willekeurige getallen.

Codes voor afbeeldingsstijl, opgegeven als hexadecimale tekenreeksen van elk 8 tekens; laat zowel style_reference_images als style weg wanneer je deze lijst gebruikt.

Kleurenpalet dat tijdens de generatie wordt gebruikt. Geef een preset op via name of expliciete hexadecimale kleuren via members, eventueel met gewichten.

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

Deze request uitvoeren

Je sleutel blijft in deze browser: hij wordt alleen naar de Doitong API verzonden en alleen in localStorage opgeslagen als je Onthouden aanvinkt. API-sleutel ophalen

Over Ideogram V3 Character Edit

Vult een gemaskeerd gebied van `image_url` in met `mask_url` (beide moeten identieke afmetingen hebben), een `prompt` en een personagereferentie in `reference_image_urls` (1 afbeelding gebruikt). Handig voor het wijzigen van houding, expressie of kleding. Optionele stijlgerefenties, `rendering_speed` en maximaal 8 uitvoerafbeeldingen.

Parameters

Stuur de canonieke naam of de oorspronkelijke naam, niet beide. Canonieke namen

NaamType StandaardToegestaan Beschrijving
image_urlsoptioneel images
Typeurl[] · image
Stijlreferentieafbeeldingen in JPEG-, PNG- of WebP-indeling. De gecombineerde grootte mag niet groter zijn dan 10 MB.
rendering_speedoptioneel
Typeenum
StandaardBALANCED
TURBOBALANCEDQUALITY
Snelheidsinstelling voor rendering.
color_paletteoptioneel
Typeobject
Kleurenpalet dat tijdens de generatie wordt gebruikt. Geef een preset op via name of expliciete hexadecimale kleuren via members, eventueel met gewichten.
color_palette.membersoptioneel
Typeobject[]
Lijst met paletleden die de kleuren van het palet definieert.
color_palette.members[].rgbverplicht
Typeobject
Kleur van het paletlid, uitgedrukt als RGB.
color_palette.members[].color_weightoptioneel
Typenumber | null
Standaard0.5
0,05 – 1
Gewicht dat aan deze kleur binnen het palet is toegewezen.
color_palette.nameoptioneel
Typeenum
EMBERFRESHJUNGLEMAGICMELONMOSAICPASTELULTRAMARINE
Presetselectie voor het kleurenpalet.
style_codesoptioneel
Typestring[]
Codes voor afbeeldingsstijl, opgegeven als hexadecimale tekenreeksen van elk 8 tekens; laat zowel style_reference_images als style weg wanneer je deze lijst gebruikt.
expand_promptoptioneel
Typeboolean
Standaardtrue
Schakelaar voor MagicPrompt-gebruik bij het genereren van een request.
num_imagesoptioneel num_outputs
Typeinteger
Standaard1
1 – 8
Aantal te produceren afbeeldingen.
seedoptioneel
Typeinteger | null
Seedwaarde voor het genereren van willekeurige getallen.
promptverplicht
Typestring
Prompt die de vulling voor het gemaskeerde gebied van de afbeelding beschrijft.
image_urlverplicht image
Typeurl · image
Generatiebron opgegeven als afbeeldings-URL, waarbij zowel de breedte als de hoogte exact gelijk moeten zijn aan de overeenkomstige afmetingen van het masker.
mask_urlverplicht mask
Typeurl · image
Inpaintingmasker opgegeven via URL, waarbij zowel de breedte als de hoogte exact gelijk moeten zijn aan de overeenkomstige afmetingen van de invoerafbeelding.
reference_image_urlsverplicht
Typeurl[] · image
Karakterreferentieafbeeldingen in JPEG-, PNG- of WebP-indeling, met een gezamenlijke limiet van 10 MB voor alle karakterreferenties. Momenteel wordt slechts 1 afbeelding ondersteund; extra afbeeldingen worden genegeerd.
reference_mask_urlsoptioneel
Typeurl[] · image
Maskers voor karakterreferenties in JPEG-, PNG- of WebP-indeling; de totale grootte van alle karakterreferenties mag niet groter zijn dan 10 MB. Momenteel wordt slechts 1 masker gebruikt; extra maskers worden genegeerd.
verplicht Canonieke naam, ook geaccepteerd

Bestandsparameters accepteren een openbare https:// URL, een data: URI tot 10 MB of de file_url van een upload. Bestanden

Uitvoer

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"
  }
}
Jouw bestanden, jouw keuzeElke outputs[].url is een kopie in onze opslag: voor altijd bewaard (betaald per GB-maand) of 7 dagen gratis, volgens je accountinstelling of ?storage=.
Dezelfde structuur voor elk modeltype, url, content_type, width, height en duration, voor afbeeldingen, video en audio. output is het eigen resultaatobject van het model.
Velden van de uitvoer
images
array of object {url, content_type, file_name, file_size}
seed
integerSeedwaarde die voor het genereren van willekeurige getallen wordt gebruikt.

Meer modellen: Afbeelding bewerken

Voor AI-agents: deze pagina als Markdown staat op https://doitong.com/nl/developers/models/ideogram/character/edit.md. Alle modellen en handleidingen: https://doitong.com/developers/llms.txt