ImageGenTool interface

Pacote:
@azure/ai-projects

Uma ferramenta que gera imagens usando os modelos de imagem GPT.

Extends
Tool

Propriedades

action

Se deve gerar uma nova imagem ou editar uma imagem existente. Padrão: auto.
background

Tipo de plano de fundo para a imagem gerada. Um de transparent, opaqueou auto. Padrão: auto.
description

Deprecated. Esta propriedade está obsoleta e será removida numa versão futura.
input_fidelity

O nível de fidelidade para o processamento de imagens de entrada.
input_image_mask

Máscara opcional para inpainting. Contém image_url (string, opcional) e file_id (string, opcional).
model

O modelo a ser usado para geração de imagens.
moderation

Nível de moderação para a imagem gerada. Padrão: auto.
name

Deprecated. Esta propriedade está obsoleta e será removida numa versão futura.
output_compression

Nível de compressão para a imagem de saída. Padrão: 100.
output_format

O formato de saída da imagem gerada. Um de png, webpou jpeg. Padrão: png.
partial_images

Número de imagens parciais para gerar no modo de streaming, de 0 (valor padrão) a 3.
quality

A qualidade da imagem gerada. Um de low, medium, high, ou auto. Padrão: auto.
size

O tamanho das imagens geradas. Para gpt-image-2 e gpt-image-2-2026-04-21, resoluções arbitrárias são suportadas como WIDTHxHEIGHT cadeias, por exemplo 1536x864. A largura e a altura devem ser ambas divisíveis por 16 e a razão de aspeto solicitada deve estar entre 1:3 e 3:1. As resoluções acima 2560x1440 são experimentais, e a resolução máxima suportada é 3840x2160. O tamanho solicitado deve também satisfazer os limites atuais de píxeis e bordas do modelo. Os tamanhos 1024x1024padrão , 1536x1024, e 1024x1536 são suportados pelos modelos de imagem GPT; auto é suportado para modelos que permitem o dimensionamento automático. Para dall-e-2, use um dos 256x256, 512x512, ou 1024x1024. Para dall-e-3, use um dos 1024x1024, 1792x1024, ou 1024x1792.
tool_configs

Deprecated. Esta propriedade está obsoleta e será removida numa versão futura.
type

O tipo da ferramenta de geração de imagem. Sempre image_generation.

Detalhes de Propriedade

action

Se deve gerar uma nova imagem ou editar uma imagem existente. Padrão: auto.

action?: ImageGenAction

Valor de Propriedade

ImageGenAction

background

Tipo de plano de fundo para a imagem gerada. Um de transparent, opaqueou auto. Padrão: auto.

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

Valor de Propriedade

"auto" | "transparent" | "opaque"

description

Deprecated. Esta propriedade está obsoleta e será removida numa versão futura.

description?: string

Valor de Propriedade

string

input_fidelity

O nível de fidelidade para o processamento de imagens de entrada.

input_fidelity?: InputFidelity

Valor de Propriedade

InputFidelity

input_image_mask

Máscara opcional para inpainting. Contém image_url (string, opcional) e file_id (string, opcional).

input_image_mask?: ImageGenToolInputImageMask

Valor de Propriedade

ImageGenToolInputImageMask

model

O modelo a ser usado para geração de imagens.

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

Valor de Propriedade

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

moderation

Nível de moderação para a imagem gerada. Padrão: auto.

moderation?: "auto" | "low"

Valor de Propriedade

"auto" | "low"

name

Deprecated. Esta propriedade está obsoleta e será removida numa versão futura.

name?: string

Valor de Propriedade

string

output_compression

Nível de compressão para a imagem de saída. Padrão: 100.

output_compression?: number

Valor de Propriedade

number

output_format

O formato de saída da imagem gerada. Um de png, webpou jpeg. Padrão: png.

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

Valor de Propriedade

"png" | "webp" | "jpeg"

partial_images

Número de imagens parciais para gerar no modo de streaming, de 0 (valor padrão) a 3.

partial_images?: number

Valor de Propriedade

number

quality

A qualidade da imagem gerada. Um de low, medium, high, ou auto. Padrão: auto.

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

Valor de Propriedade

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

size

O tamanho das imagens geradas. Para gpt-image-2 e gpt-image-2-2026-04-21, resoluções arbitrárias são suportadas como WIDTHxHEIGHT cadeias, por exemplo 1536x864. A largura e a altura devem ser ambas divisíveis por 16 e a razão de aspeto solicitada deve estar entre 1:3 e 3:1. As resoluções acima 2560x1440 são experimentais, e a resolução máxima suportada é 3840x2160. O tamanho solicitado deve também satisfazer os limites atuais de píxeis e bordas do modelo. Os tamanhos 1024x1024padrão , 1536x1024, e 1024x1536 são suportados pelos modelos de imagem GPT; auto é suportado para modelos que permitem o dimensionamento automático. Para dall-e-2, use um dos 256x256, 512x512, ou 1024x1024. Para dall-e-3, use um dos 1024x1024, 1792x1024, ou 1024x1792.

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

Valor de Propriedade

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

tool_configs

Deprecated. Esta propriedade está obsoleta e será removida numa versão futura.

tool_configs?: Record<string, ToolConfig>

Valor de Propriedade

Record<string, ToolConfig>

type

O tipo da ferramenta de geração de imagem. Sempre image_generation.

type: "image_generation"

Valor de Propriedade

"image_generation"