ImageGenTool interface

Pacchetto:

@azure/ai-projects

Uno strumento che genera immagini utilizzando i modelli immagine GPT.

Extends

Tool

Proprietà

action	Se generare una nuova immagine o modificare un'immagine esistente. Impostazione predefinita: auto.
background	Tipo di sfondo per l'immagine generata. Uno tra transparent, opaque e auto. Impostazione predefinita: auto.
description	Deprecated. Questa proprietà è stata deprecata e sarà rimossa in una versione futura.
input_fidelity	Il livello di fedeltà per l'elaborazione delle immagini in input.
input_image_mask	Maschera opzionale per ritocco immagine. Contiene image_url (stringa, facoltativa) e file_id (stringa, facoltativa).
model	Modello da usare per la generazione di immagini.
moderation	Livello di moderazione per l'immagine generata. Impostazione predefinita: auto.
name	Deprecated. Questa proprietà è stata deprecata e sarà rimossa in una versione futura.
output_compression	Livello di compressione per l'immagine di output. Predefinito: 100.
output_format	Formato di output dell'immagine generata. Uno tra png, webp e jpeg. Impostazione predefinita: png.
partial_images	Numero di immagini parziali da generare in modalità di streaming, da 0 (valore predefinito) a 3.
quality	Qualità dell'immagine generata. Uno tra low, medium, high o auto. Impostazione predefinita: auto.
size	La dimensione delle immagini generate. Per gpt-image-2 e gpt-image-2-2026-04-21, risoluzioni arbitrarie sono supportate come WIDTHxHEIGHT stringhe, ad esempio 1536x864. Larghezza e altezza devono essere entrambe divisibili per 16 e il rapporto d'aspetto richiesto deve essere tra 1:3 e 3:1. Le risoluzioni sopra 2560x1440 sono sperimentali, e la risoluzione massima supportata è 3840x2160. La dimensione richiesta deve anche soddisfare i limiti attuali di pixel e bordi del modello. Le dimensioni 1024x1024standard , 1536x1024, e 1024x1536 sono supportate dai modelli immagine GPT; auto è supportata per modelli che permettono il dimensionamento automatico. Per dall-e-2, usa uno di 256x256, 512x512, o 1024x1024. Per dall-e-3, usa uno di 1024x1024, 1792x1024, o 1024x1792.
tool_configs	Deprecated. Questa proprietà è stata deprecata e sarà rimossa in una versione futura.
type	Tipo dello strumento di generazione di immagini. Sempre image_generation.

Dettagli proprietà

action

Se generare una nuova immagine o modificare un'immagine esistente. Impostazione predefinita: auto.

action?: ImageGenAction

Valore della proprietà

ImageGenAction

background

Tipo di sfondo per l'immagine generata. Uno tra transparent, opaque e auto. Impostazione predefinita: auto.

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

Valore della proprietà

"auto" | "transparent" | "opaque"

description

Deprecated. Questa proprietà è stata deprecata e sarà rimossa in una versione futura.

description?: string

Valore della proprietà

string

input_fidelity

Il livello di fedeltà per l'elaborazione delle immagini in input.

input_fidelity?: InputFidelity

Valore della proprietà

InputFidelity

input_image_mask

Maschera opzionale per ritocco immagine. Contiene image_url (stringa, facoltativa) e file_id (stringa, facoltativa).

input_image_mask?: ImageGenToolInputImageMask

Valore della proprietà

ImageGenToolInputImageMask

model

Modello da usare per la generazione di immagini.

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

Valore della proprietà

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

moderation

Livello di moderazione per l'immagine generata. Impostazione predefinita: auto.

moderation?: "auto" | "low"

Valore della proprietà

"auto" | "low"

name

Deprecated. Questa proprietà è stata deprecata e sarà rimossa in una versione futura.

name?: string

Valore della proprietà

string

output_compression

Livello di compressione per l'immagine di output. Predefinito: 100.

output_compression?: number

Valore della proprietà

number

output_format

Formato di output dell'immagine generata. Uno tra png, webp e jpeg. Impostazione predefinita: png.

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

Valore della proprietà

"png" | "webp" | "jpeg"

partial_images

Numero di immagini parziali da generare in modalità di streaming, da 0 (valore predefinito) a 3.

partial_images?: number

Valore della proprietà

number

quality

Qualità dell'immagine generata. Uno tra low, medium, high o auto. Impostazione predefinita: auto.

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

Valore della proprietà

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

size

La dimensione delle immagini generate. Per gpt-image-2 e gpt-image-2-2026-04-21, risoluzioni arbitrarie sono supportate come WIDTHxHEIGHT stringhe, ad esempio 1536x864. Larghezza e altezza devono essere entrambe divisibili per 16 e il rapporto d'aspetto richiesto deve essere tra 1:3 e 3:1. Le risoluzioni sopra 2560x1440 sono sperimentali, e la risoluzione massima supportata è 3840x2160. La dimensione richiesta deve anche soddisfare i limiti attuali di pixel e bordi del modello. Le dimensioni 1024x1024standard , 1536x1024, e 1024x1536 sono supportate dai modelli immagine GPT; auto è supportata per modelli che permettono il dimensionamento automatico. Per dall-e-2, usa uno di 256x256, 512x512, o 1024x1024. Per dall-e-3, usa uno di 1024x1024, 1792x1024, o 1024x1792.

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

Valore della proprietà

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

tool_configs

Deprecated. Questa proprietà è stata deprecata e sarà rimossa in una versione futura.

tool_configs?: Record<string, ToolConfig>

Valore della proprietà

Record<string, ToolConfig>

type

Tipo dello strumento di generazione di immagini. Sempre image_generation.

type: "image_generation"

Valore della proprietà

"image_generation"