Naar inhoud springen

Ideogram Text to Image

Integreren

Model-ID ideogram/v3
# 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?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"
  }'

# 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,06 60 API-tegoed Op deze pagina uitvoeren

API-sleutel ophalen
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
rendering_speed standaard BALANCED

Snelheidsinstelling voor rendering.

image_size standaard square_hd

Resolutie voor de uitvoerafbeelding.

num_images standaard 1

Aantal te produceren afbeeldingen.

Geavanceerd negative_prompt · images · style · style_preset · seed · expand_prompt · style_codes · color_palette
standaard

Geef ongewenste afbeeldingsinhoud op; beschrijvingen in de hoofdprompt hebben voorrang op deze beschrijvingen in de negatieve prompt.

image_urls
Sleep een bestand hierheen of

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

style

Stijltype voor de generatie; wederzijds exclusief met style_codes.

Stijlvoorinstelling die de selectie van de beeldgeneratie aanstuurt.

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/v3?wait=20 prijsopgave → $ 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?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"
  }'

# 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 Text to Image

Genereert afbeeldingen vanuit een `prompt` met rendersnelheden TURBO, BALANCED of QUALITY. Stuur de uitstraling met stijlgerefentieafbeeldingen (`image_urls`), `style_codes`, een `color_palette`, een `style` of een van 62 `style_preset`-waarden. Ondersteunt maximaal 8 afbeeldingen per aanroep, een negatieve prompt, optionele promptuitbreiding en formaatpresets.

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.
styleoptioneel
Typeenum
AUTOGENERALREALISTICDESIGN
Stijltype voor de generatie; wederzijds exclusief met style_codes.
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.
style_presetoptioneel
Typeenum
80S_ILLUSTRATION90S_NOSTALGIAABSTRACT_ORGANICANALOG_NOSTALGIAART_BRUTART_DECOART_POSTERAURAAVANT_GARDEBAUHAUSBLUEPRINTBLURRY_MOTIONBRIGHT_ARTC4D_CARTOONCHILDRENS_BOOKCOLLAGE
+46 meerCOLORING_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
Stijlvoorinstelling die de selectie van de beeldgeneratie aanstuurt.
promptverplicht
Typestring
image_sizeoptioneel
Typeobject
Standaardsquare_hd
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Resolutie voor de uitvoerafbeelding.
negative_promptoptioneel
Typestring
Standaard
Geef ongewenste afbeeldingsinhoud op; beschrijvingen in de hoofdprompt hebben voorrang op deze beschrijvingen in de negatieve prompt.
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/v3",
  "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"
  },
  "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: Tekst naar afbeelding

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