Naar inhoud springen

Ideogram · v3 · Reframe

Integreren

Model-ID ideogram/v3/reframe
# 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/reframe?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "image_size": "square_hd"
  }'

# 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 image_url
Sleep een bestand hierheen of

URL die verwijst naar de afbeelding waarvan de beeldverhouding wordt aangepast.

rendering_speed standaard BALANCED

Snelheidsinstelling voor rendering.

image_size •verplicht

Resolutie van de afbeelding die door het aanpassen van de beeldverhouding wordt geproduceerd.

num_images standaard 1

Aantal te produceren afbeeldingen.

Geavanceerd images · style · style_preset · seed · 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.

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/reframe?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/reframe?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "image_size": "square_hd"
  }'

# 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 · Reframe

Past het kader van een bestaande afbeelding (`image_url`) aan een vereiste `image_size` aan, zoals vierkante, staande of liggende voorinstellingen, en genereert nieuwe inhoud om de extra ruimte op te vullen. De stijl kan worden gestuurd met referentieafbeeldingen, `style_codes`, een `color_palette`, een `style` of een `style_preset`. Ondersteunt de snelheden TURBO, BALANCED of QUALITY en 1 tot 8 uitvoeren.

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.
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.
image_urlverplicht image
Typeurl · image
URL die verwijst naar de afbeelding waarvan de beeldverhouding wordt aangepast.
image_sizeverplicht
Typeobject
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Resolutie van de afbeelding die door het aanpassen van de beeldverhouding wordt geproduceerd.
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/reframe",
  "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": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "image_size": "square_hd"
  },
  "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/v3/reframe.md. Alle modellen en handleidingen: https://doitong.com/developers/llms.txt