ImageGenTool interface

GPT görüntü modelleriyle görüntü üreten bir araç.

Extends

Özellikler

action

Yeni bir görüntü oluşturmak ya da mevcut bir görüntüyü düzenlemek istemek. Varsayılan: auto.

background

Oluşturulan görüntünün arka plan türü. transparent, opaqueveya auto. Varsayılan: auto.

description

Deprecated. Bu özellik kullanımdan kaldırılmıştır ve gelecekteki bir sürümde kaldırılacaktır.

input_fidelity

Giriş görüntü işleme için doğruluk seviyesi.

input_image_mask

Boyanma için isteğe bağlı maske. İçerir image_url (dize, isteğe bağlı) ve file_id (dize, isteğe bağlı).

model

Görüntü oluşturma için kullanılacak model.

moderation

Oluşturulan görüntü için denetim düzeyi. Varsayılan: auto.

name

Deprecated. Bu özellik kullanımdan kaldırılmıştır ve gelecekteki bir sürümde kaldırılacaktır.

output_compression

Çıkış görüntüsü için sıkıştırma düzeyi. Varsayılan: 100.

output_format

Oluşturulan görüntünün çıkış biçimi. png, webpveya jpeg. Varsayılan: png.

partial_images

Akış modunda 0 'dan (varsayılan değer) 3'e kadar oluşturulacak kısmi görüntü sayısı.

quality

Oluşturulan görüntünün kalitesi. low, medium, high veya auto. Varsayılan: auto.

size

Oluşturulan görüntülerin boyutu. ve içingpt-image-2, rastgele çözünürlükler dizi WIDTHxHEIGHT olarak desteklenir, örneğin 1536x864.gpt-image-2-2026-04-21 Genişlik ve yükseklik 16'ya bölünebilir olmalı ve istenen en-boy oranı 1:3 ile 3:1 arasında olmalıdır. Yukarıdaki 2560x1440 çözümler deneyseldir ve desteklenen maksimum çözünürlük .3840x2160 İstenen boyut ayrıca modelin mevcut piksel ve kenar sınırlarını karşılamalıdır. Standart boyutlar 1024x1024, 1536x1024, ve 1024x1536 GPT görüntü modelleri tarafından desteklenir; auto otomatik boyutlandırmaya izin veren modeller için desteklenir. için, dall-e-2, veya '256x256512x5121024x1024den birini kullanın. için, dall-e-3, veya '1024x10241792x10241024x1792den birini kullanın.

tool_configs

Deprecated. Bu özellik kullanımdan kaldırılmıştır ve gelecekteki bir sürümde kaldırılacaktır.

type

Görüntü oluşturma aracının türü. Her zaman image_generation.

Özellik Ayrıntıları

action

Yeni bir görüntü oluşturmak ya da mevcut bir görüntüyü düzenlemek istemek. Varsayılan: auto.

action?: ImageGenAction

Özellik Değeri

background

Oluşturulan görüntünün arka plan türü. transparent, opaqueveya auto. Varsayılan: auto.

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

Özellik Değeri

"auto" | "transparent" | "opaque"

description

Deprecated. Bu özellik kullanımdan kaldırılmıştır ve gelecekteki bir sürümde kaldırılacaktır.

description?: string

Özellik Değeri

string

input_fidelity

Giriş görüntü işleme için doğruluk seviyesi.

input_fidelity?: InputFidelity

Özellik Değeri

input_image_mask

Boyanma için isteğe bağlı maske. İçerir image_url (dize, isteğe bağlı) ve file_id (dize, isteğe bağlı).

input_image_mask?: ImageGenToolInputImageMask

Özellik Değeri

model

Görüntü oluşturma için kullanılacak model.

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

Özellik Değeri

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

moderation

Oluşturulan görüntü için denetim düzeyi. Varsayılan: auto.

moderation?: "auto" | "low"

Özellik Değeri

"auto" | "low"

name

Deprecated. Bu özellik kullanımdan kaldırılmıştır ve gelecekteki bir sürümde kaldırılacaktır.

name?: string

Özellik Değeri

string

output_compression

Çıkış görüntüsü için sıkıştırma düzeyi. Varsayılan: 100.

output_compression?: number

Özellik Değeri

number

output_format

Oluşturulan görüntünün çıkış biçimi. png, webpveya jpeg. Varsayılan: png.

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

Özellik Değeri

"png" | "webp" | "jpeg"

partial_images

Akış modunda 0 'dan (varsayılan değer) 3'e kadar oluşturulacak kısmi görüntü sayısı.

partial_images?: number

Özellik Değeri

number

quality

Oluşturulan görüntünün kalitesi. low, medium, high veya auto. Varsayılan: auto.

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

Özellik Değeri

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

size

Oluşturulan görüntülerin boyutu. ve içingpt-image-2, rastgele çözünürlükler dizi WIDTHxHEIGHT olarak desteklenir, örneğin 1536x864.gpt-image-2-2026-04-21 Genişlik ve yükseklik 16'ya bölünebilir olmalı ve istenen en-boy oranı 1:3 ile 3:1 arasında olmalıdır. Yukarıdaki 2560x1440 çözümler deneyseldir ve desteklenen maksimum çözünürlük .3840x2160 İstenen boyut ayrıca modelin mevcut piksel ve kenar sınırlarını karşılamalıdır. Standart boyutlar 1024x1024, 1536x1024, ve 1024x1536 GPT görüntü modelleri tarafından desteklenir; auto otomatik boyutlandırmaya izin veren modeller için desteklenir. için, dall-e-2, veya '256x256512x5121024x1024den birini kullanın. için, dall-e-3, veya '1024x10241792x10241024x1792den birini kullanın.

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

Özellik Değeri

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

tool_configs

Deprecated. Bu özellik kullanımdan kaldırılmıştır ve gelecekteki bir sürümde kaldırılacaktır.

tool_configs?: Record<string, ToolConfig>

Özellik Değeri

Record<string, ToolConfig>

type

Görüntü oluşturma aracının türü. Her zaman image_generation.

type: "image_generation"

Özellik Değeri

"image_generation"