ImageGenTool interface

Balíček:

@azure/ai-projects

Nástroj, který generuje obrázky pomocí GPT modelů obrazů.

Extends

Tool

Vlastnosti

action	Zda vytvořit nový obrázek, nebo upravit existující. Výchozí hodnota: auto.
background	Typ pozadí pro vygenerovaný obrázek Jeden z transparent, opaquenebo auto. Výchozí hodnota: auto.
description	Deprecated. Tato nemovitost je zastaralá a bude odstraněna v budoucí verzi.
input_fidelity	Úroveň věrnosti pro zpracování vstupního obrazu.
input_image_mask	Volitelná maska pro inpainting Obsahuje image_url (řetězec, volitelné) a file_id (řetězec, volitelné).
model	Model, který se má použít pro generování imagí.
moderation	Úroveň moderování pro vygenerovanou image Výchozí hodnota: auto.
name	Deprecated. Tato nemovitost je zastaralá a bude odstraněna v budoucí verzi.
output_compression	Úroveň komprese pro výstupní obrázek. Výchozí hodnota: 100.
output_format	Výstupní formát vygenerované image. Jeden z png, webpnebo jpeg. Výchozí hodnota: png.
partial_images	Počet částečných imagí, které se mají vygenerovat v režimu streamování, od 0 (výchozí hodnota) do 3
quality	Kvalita vygenerované image. Jeden z low, medium, highnebo auto. Výchozí hodnota: auto.
size	Velikost generovaných obrázků. Pro gpt-image-2 a gpt-image-2-2026-04-21jsou libovolná rozlišení podporována jako WIDTHxHEIGHT řetězce, například 1536x864. Šířka i výška musí být dělitelné 16 a požadovaný poměr stran musí být mezi 1:3 a 3:1. Výše uvedená rozlišení 2560x1440 jsou experimentální a maximální podporované rozlišení je 3840x2160. Požadovaná velikost musí také splňovat aktuální limity počtu pixelů a hran modelu. Standardní velikosti 1024x1024, 1536x1024, a jsou 1024x1536 podporovány modely GPT obrazů; auto je podporováno pro modely, které umožňují automatické zvětšování. Pro dall-e-2, použijte jeden z 256x256, 512x512, nebo 1024x1024. Pro dall-e-3, použijte jeden z 1024x1024, 1792x1024, nebo 1024x1792.
tool_configs	Deprecated. Tato nemovitost je zastaralá a bude odstraněna v budoucí verzi.
type	Typ nástroje pro generování obrázků. Vždy image_generation.

Podrobnosti vlastnosti

action

Zda vytvořit nový obrázek, nebo upravit existující. Výchozí hodnota: auto.

action?: ImageGenAction

Hodnota vlastnosti

ImageGenAction

background

Typ pozadí pro vygenerovaný obrázek Jeden z transparent, opaquenebo auto. Výchozí hodnota: auto.

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

Hodnota vlastnosti

"auto" | "transparent" | "opaque"

description

Deprecated. Tato nemovitost je zastaralá a bude odstraněna v budoucí verzi.

description?: string

Hodnota vlastnosti

string

input_fidelity

Úroveň věrnosti pro zpracování vstupního obrazu.

input_fidelity?: InputFidelity

Hodnota vlastnosti

InputFidelity

input_image_mask

Volitelná maska pro inpainting Obsahuje image_url (řetězec, volitelné) a file_id (řetězec, volitelné).

input_image_mask?: ImageGenToolInputImageMask

Hodnota vlastnosti

ImageGenToolInputImageMask

model

Model, který se má použít pro generování imagí.

model?: "gpt-image-1" | "gpt-image-1-mini" | "gpt-image-1.5" | "gpt-image-2" | "gpt-image-2-2026-04-21"

Hodnota vlastnosti

"gpt-image-1" | "gpt-image-1-mini" | "gpt-image-1.5" | "gpt-image-2" | "gpt-image-2-2026-04-21"

moderation

Úroveň moderování pro vygenerovanou image Výchozí hodnota: auto.

moderation?: "auto" | "low"

Hodnota vlastnosti

"auto" | "low"

name

Deprecated. Tato nemovitost je zastaralá a bude odstraněna v budoucí verzi.

name?: string

Hodnota vlastnosti

string

output_compression

Úroveň komprese pro výstupní obrázek. Výchozí hodnota: 100.

output_compression?: number

Hodnota vlastnosti

number

output_format

Výstupní formát vygenerované image. Jeden z png, webpnebo jpeg. Výchozí hodnota: png.

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

Hodnota vlastnosti

"png" | "webp" | "jpeg"

partial_images

Počet částečných imagí, které se mají vygenerovat v režimu streamování, od 0 (výchozí hodnota) do 3

partial_images?: number

Hodnota vlastnosti

number

quality

Kvalita vygenerované image. Jeden z low, medium, highnebo auto. Výchozí hodnota: auto.

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

Hodnota vlastnosti

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

size

Velikost generovaných obrázků. Pro gpt-image-2 a gpt-image-2-2026-04-21jsou libovolná rozlišení podporována jako WIDTHxHEIGHT řetězce, například 1536x864. Šířka i výška musí být dělitelné 16 a požadovaný poměr stran musí být mezi 1:3 a 3:1. Výše uvedená rozlišení 2560x1440 jsou experimentální a maximální podporované rozlišení je 3840x2160. Požadovaná velikost musí také splňovat aktuální limity počtu pixelů a hran modelu. Standardní velikosti 1024x1024, 1536x1024, a jsou 1024x1536 podporovány modely GPT obrazů; auto je podporováno pro modely, které umožňují automatické zvětšování. Pro dall-e-2, použijte jeden z 256x256, 512x512, nebo 1024x1024. Pro dall-e-3, použijte jeden z 1024x1024, 1792x1024, nebo 1024x1792.

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

Hodnota vlastnosti

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

tool_configs

Deprecated. Tato nemovitost je zastaralá a bude odstraněna v budoucí verzi.

tool_configs?: Record<string, ToolConfig>

Hodnota vlastnosti

Record<string, ToolConfig>

type

Typ nástroje pro generování obrázků. Vždy image_generation.

type: "image_generation"

Hodnota vlastnosti

"image_generation"