Entegrasyon rehberleri · 2026-10-06

OpenAI gpt-image-2 şeffaf arka plan 400 hatası

gpt-image-2 şeffaf arka plan 400 hatasının nedeni: OpenAI desteği 20 Ağustos 2026'da önizleme olarak açtı. png veya webp ile çalışan istek ve parametreler.

Kısa yanıt: şeffaf arka plan png veya webp ile çalışır

LLMTR (llmtr.com), Türkiye'de ve global sağlayıcılarda barındırılan dil modellerine tek, OpenAI uyumlu API'den erişim veren bir gateway'dir. OpenAI, openai/gpt-image-2 için şeffaf arka planı 20 Ağustos 2026'da önizleme olarak açtı; bu tarihten önce background transparent isteği 400 hatasıyla reddediliyordu. LLMTR üzerinde POST https://llmtr.com/v1/images/generations isteğinde background transparent, output_format png veya webp ile gönderilir. output_format jpeg ile transparent 400 invalid_request döndürür, çünkü jpeg alfa kanalı taşımaz.

Özellik önizleme durumundadır ve OpenAI davranışı değiştirebilir. Önizlemeye bağlı kalmak istemeyen iş akışlarında background opaque ile düz ve tek renkli bir zemin üretip bu zemini kendi görüntü işleme hattınızda kaldırmak da çalışır. Diğer arka plan değerleri olan opaque ve auto değişmeden kabul edilir.

OpenAI gpt-image-2 transparent background is not supported for this model 400 hatası

Bu 400 hatası, OpenAI'nin 20 Ağustos 2026'dan önceki davranışıdır; o tarihten beri gpt-image-2 background transparent değerini önizleme olarak kabul eder. Bugün aynı istek 400 döndürüyorsa output_format değerine bakın: LLMTR'de transparent ile jpeg seçildiğinde istek invalid_request türünde ve transparent background requires output_format png or webp mesajıyla reddedilir.

Çözüm, output_format değerini png veya webp yapmaktır. png kayıpsızdır ve en yaygın seçimdir; webp daha küçük dosya üretir ve output_compression ile birlikte kullanılabilir. output_format gönderilmezse varsayılan png olduğu için transparent tek başına da çalışır.

LLMTR üzerinde geçerli gpt-image-2 parametreleri

Tablo, /v1/images/generations üzerinde kullanılabilen temel alanları ve varsayılanları gösterir. moderation auto veya low değerini kabul eder. image_url, image_urls, file_id, file_ids, mask, stream ve partial_images alanları bu uç noktada reddedilir. output_compression değeri 0-100 aralığındadır, ancak yalnızca jpeg veya webp ile kullanılabilir; png ile gönderildiğinde 400 invalid_request hatası oluşur.

LLMTR /v1/images/generations üzerinde gpt-image-2 parametreleri
Alan	Değerler	Not
background	opaque, auto, transparent	transparent yalnızca png ve webp ile, önizleme
output_format	png, jpeg, webp	varsayılan png
size	1024x1024, 1024x1536, 1536x1024	varsayılan 1024x1024
quality	low, medium, high	varsayılan medium
output_compression	0-100	yalnızca jpeg ve webp
n	1-4	istek başına görüntü

Çalışan gpt-image-2 şeffaf görüntü isteği

POST /v1/images/generations isteğinde model openai/gpt-image-2 olarak gönderilir. background transparent ve output_format png seçilir; size 1024x1024 ve quality medium değerleri örneğe dahildir. Prompt, nesnenin arka plansız ve ortalanmış olmasını ister; şeffaflığı prompt değil background alanı belirler.

Yanıttaki data[0].b64_json alanı görüntü verisini taşır; mime_type değeri image/png olur. Base64 içeriği çözüp dosyaya yazdığınızda PNG alfa kanalıyla birlikte kaydedilir. Aynı istekte output_format jpeg seçilirse istek modele gönderilmeden 400 invalid_request ile reddedilir.

Bu curl isteği, transparent arka plan ve PNG çıktıyla çalışan gpt-image-2 çağrısını gösterir.

curl https://llmtr.com/v1/images/generations \
  -H "Authorization: Bearer $LLMTR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-image-2",
    "prompt": "Flat vector icon of a paper plane, centered, isolated with no background",
    "background": "transparent",
    "output_format": "png",
    "size": "1024x1024",
    "quality": "medium"
  }'
# "background": "transparent" with "output_format": "jpeg" returns 400 invalid_request:
# transparent background requires output_format png or webp

Önizleme dışı yol ve gpt-image-2 fiyatları

Şeffaf arka plan önizleme özelliği olduğundan sonuç kalitesi ve davranış değişebilir. Kenarları kesin olması gereken varlıklarda ikinci bir yol olarak background opaque ile düz ve tek renkli bir zemin isteyin, output_format png kullanın ve bu zemini kendi görüntü işleme hattınızda kaldırın.

OpenAI'nin görüntü üretim rehberi, şeffaf arka plan için background transparent ve output_format png veya webp kullanımını açıklar. Rehberde adı geçen yeni modeller gpt-image-2.5-sunburst ve gpt-image-2.5-flare'dir. Bu modeller 2026-10-06 itibarıyla LLMTR kataloğunda değildir; şeffaflık için gpt-image-2 kullanılır.

LLMTR'deki gpt-image-2 fiyatlandırması 1M token başıncadır: metin girdisi 5 $, görüntü girdisi 8 $ ve görüntü çıktısı 30 $. Token bazlı faturalama nedeniyle görüntü başına maliyet size ve quality seçimine bağlıdır; sabit bir görüntü birim fiyatı verilmez.

LLMTR ile başlamak: hesap, kredi, anahtar ve ilk istek

Adım 1: llmtr.com üzerinde hesabınızı oluşturun ve e-posta adresinizi doğrulayın. Adım 2: Dashboard üzerinden kredi yükleyin; güvenli ödeme ekranında istenen tutarı tamamlayın. Platform marjı %8 olarak bir kez eklenir: 10,00 $ kredi için 10,80 $ tahsil edilir. Bu marj model fiyatlarına eklenmez; her API çağrısı modelin katalog fiyatından düşülür.

Adım 3: Dashboard > API Keys bölümünde bir API anahtarı oluşturun. Anahtar yalnızca bir kez gösterilir; LLMTR_API_KEY gibi bir ortam değişkeninde saklayın. Adım 4: ilk isteği https://llmtr.com/v1 adresine gönderin ve OpenAI uyumlu herhangi bir SDK'da yalnızca base_url ile api_key değerlerini değiştirin. Dashboard kullanım sayfasında anahtar bazlı kullanım ve harcama görülür. Aynı anahtar ve kredi bakiyesi katalogdaki her model için çalışır; model değiştirmek model metnini değiştirmek demektir.

gpt-image-2 ile ilk görsel isteği

Hesap ve kredi hazırlığından sonra API anahtarınızla gpt-image-2 şeffaf PNG üretme isteği gönderin.

Hesabı oluşturun. llmtr.com üzerinde hesabınızı oluşturun ve e-posta adresinizi doğrulayın.
Kredi yükleyin. Dashboard üzerinden kredi yükleyin. İstenen %8 platform marjı bir kez eklenir; 10,00 $ kredi için 10,80 $ tahsil edilir.
API anahtarı oluşturun. Dashboard > API Keys bölümünde anahtarınızı oluşturun. Ham anahtar yalnızca bir kez gösterildiğinden LLMTR_API_KEY ortam değişkeninde saklayın.
İlk isteği gönderin. https://llmtr.com/v1/images/generations adresine openai/gpt-image-2 modelini, transparent background değerini ve PNG çıktı biçimini içeren isteği gönderin.

Sık sorulan sorular

gpt-image-2 şeffaf arka plan neden 400 döndürür?

OpenAI şeffaf arka planı gpt-image-2 için 20 Ağustos 2026'da önizleme olarak açtı; 400 bu tarihten önceki davranıştır. Bugün 400 alıyorsanız output_format jpeg olabilir: transparent yalnızca png ve webp ile çalışır.

gpt-image-2 ile şeffaf PNG nasıl elde edilir?

İsteğe background transparent ve output_format png ekleyin. Özellik önizlemede olduğu için düz zeminle üretip arka planı sonradan kaldırmak ikinci bir yol olarak kalır.

gpt-image-2 hangi background değerlerini kabul eder?

background opaque, auto ve transparent değerlerini kabul eder. transparent yalnızca output_format png veya webp ile kullanılabilir; jpeg ile 400 döner.

İlgili yazılar

xAI API görsel üretimi: aspect_ratio ve b64_json