ImageGenTool interface

Een tool die afbeeldingen genereert met behulp van de GPT-beeldmodellen.

Uitbreiding

Eigenschappen

action

Of je nu een nieuwe afbeelding moet genereren of een bestaande afbeelding moet bewerken. Standaard: auto.

background

Achtergrondtype voor de gegenereerde afbeelding. Een van transparent, opaqueof auto. Standaard: auto.

description

Deprecated. Deze eigenschap is verouderd en zal in een toekomstige versie worden verwijderd.

input_fidelity

Het getrouwheidsniveau voor invoerbeeldverwerking.

input_image_mask

Optioneel masker voor inpainting. Bevat image_url (tekenreeks, optioneel) en file_id (tekenreeks, optioneel).

model

Het model dat moet worden gebruikt voor het genereren van afbeeldingen.

moderation

Beheerniveau voor de gegenereerde afbeelding. Standaard: auto.

name

Deprecated. Deze eigenschap is verouderd en zal in een toekomstige versie worden verwijderd.

output_compression

Compressieniveau voor de uitvoerafbeelding. Standaard: 100.

output_format

De uitvoerindeling van de gegenereerde afbeelding. Een van png, webpof jpeg. Standaard: png.

partial_images

Aantal gedeeltelijke afbeeldingen dat moet worden gegenereerd in de streamingmodus, van 0 (standaardwaarde) tot 3.

quality

De kwaliteit van de gegenereerde afbeelding. Een vanlow, medium, of highauto. Standaard: auto.

size

De grootte van de gegenereerde afbeeldingen. Voor gpt-image-2 en gpt-image-2-2026-04-21worden willekeurige resoluties ondersteund als WIDTHxHEIGHT strings, bijvoorbeeld 1536x864. Breedte en hoogte moeten beide deelbaar zijn door 16 en de gevraagde beeldverhouding moet tussen 1:3 en 3:1 liggen. De bovenstaande 2560x1440 resoluties zijn experimenteel, en de maximaal ondersteunde resolutie is 3840x2160. De gevraagde grootte moet ook voldoen aan de huidige pixel- en randlimieten van het model. De standaardgroottes 1024x1024, 1536x1024, en 1024x1536 worden ondersteund door de GPT-afbeeldingsmodellen; auto wordt ondersteund voor modellen die automatische dimensionering toestaan. Voor dall-e-2, gebruik een van 256x256, 512x512, of 1024x1024. Voor dall-e-3, gebruik een van 1024x1024, 1792x1024, of 1024x1792.

tool_configs

Deprecated. Deze eigenschap is verouderd en zal in een toekomstige versie worden verwijderd.

type

Het type tool voor het genereren van beelden. Altijd image_generation.

Eigenschapdetails

action

Of je nu een nieuwe afbeelding moet genereren of een bestaande afbeelding moet bewerken. Standaard: auto.

action?: ImageGenAction

Waarde van eigenschap

background

Achtergrondtype voor de gegenereerde afbeelding. Een van transparent, opaqueof auto. Standaard: auto.

background?: "auto" | "transparent" | "opaque"

Waarde van eigenschap

"auto" | "transparent" | "opaque"

description

Deprecated. Deze eigenschap is verouderd en zal in een toekomstige versie worden verwijderd.

description?: string

Waarde van eigenschap

string

input_fidelity

Het getrouwheidsniveau voor invoerbeeldverwerking.

input_fidelity?: InputFidelity

Waarde van eigenschap

input_image_mask

Optioneel masker voor inpainting. Bevat image_url (tekenreeks, optioneel) en file_id (tekenreeks, optioneel).

input_image_mask?: ImageGenToolInputImageMask

Waarde van eigenschap

model

Het model dat moet worden gebruikt voor het genereren van afbeeldingen.

model?: "gpt-image-1" | "gpt-image-1-mini" | "gpt-image-1.5"

Waarde van eigenschap

"gpt-image-1" | "gpt-image-1-mini" | "gpt-image-1.5"

moderation

Beheerniveau voor de gegenereerde afbeelding. Standaard: auto.

moderation?: "auto" | "low"

Waarde van eigenschap

"auto" | "low"

name

Deprecated. Deze eigenschap is verouderd en zal in een toekomstige versie worden verwijderd.

name?: string

Waarde van eigenschap

string

output_compression

Compressieniveau voor de uitvoerafbeelding. Standaard: 100.

output_compression?: number

Waarde van eigenschap

number

output_format

De uitvoerindeling van de gegenereerde afbeelding. Een van png, webpof jpeg. Standaard: png.

output_format?: "png" | "webp" | "jpeg"

Waarde van eigenschap

"png" | "webp" | "jpeg"

partial_images

Aantal gedeeltelijke afbeeldingen dat moet worden gegenereerd in de streamingmodus, van 0 (standaardwaarde) tot 3.

partial_images?: number

Waarde van eigenschap

number

quality

De kwaliteit van de gegenereerde afbeelding. Een vanlow, medium, of highauto. Standaard: auto.

quality?: "auto" | "low" | "medium" | "high"

Waarde van eigenschap

"auto" | "low" | "medium" | "high"

size

De grootte van de gegenereerde afbeeldingen. Voor gpt-image-2 en gpt-image-2-2026-04-21worden willekeurige resoluties ondersteund als WIDTHxHEIGHT strings, bijvoorbeeld 1536x864. Breedte en hoogte moeten beide deelbaar zijn door 16 en de gevraagde beeldverhouding moet tussen 1:3 en 3:1 liggen. De bovenstaande 2560x1440 resoluties zijn experimenteel, en de maximaal ondersteunde resolutie is 3840x2160. De gevraagde grootte moet ook voldoen aan de huidige pixel- en randlimieten van het model. De standaardgroottes 1024x1024, 1536x1024, en 1024x1536 worden ondersteund door de GPT-afbeeldingsmodellen; auto wordt ondersteund voor modellen die automatische dimensionering toestaan. Voor dall-e-2, gebruik een van 256x256, 512x512, of 1024x1024. Voor dall-e-3, gebruik een van 1024x1024, 1792x1024, of 1024x1792.

size?: "auto" | "1024x1024" | "1024x1536" | "1536x1024"

Waarde van eigenschap

"auto" | "1024x1024" | "1024x1536" | "1536x1024"

tool_configs

Deprecated. Deze eigenschap is verouderd en zal in een toekomstige versie worden verwijderd.

tool_configs?: Record<string, ToolConfig>

Waarde van eigenschap

Record<string, ToolConfig>

type

Het type tool voor het genereren van beelden. Altijd image_generation.

type: "image_generation"

Waarde van eigenschap

"image_generation"