Yapay zekâ API'siyle görsel nasıl üretilir ve görsel başı maliyeti ne kadar?

Kısaca: Görseli OpenAI biçimindeki /v1/images/generations ucuna model adı ve bir prompt göndererek üretirsin; görsel yanıtta base64 olarak gelir. Wiozen API'de 30 Ekim 2026 itibarıyla bir görsel FLUX.2 Klein 4B ile $0,0102, Gemini 3.1 Flash Image ile yaklaşık $0,047, GPT Image 2.5 ile boyuta göre yaklaşık $0,116 ya da $0,148 tutar. Ücret yalnız görsel sana ulaşınca bakiyeden düşer.

Hangi modellerle görsel üretebilirim?

Uç yalnız Modeller sayfasında görsel üretim kategorisinde listelenen etkin modelleri kabul eder. 30 Ekim 2026 itibarıyla bunlar üç tane: flux-2-klein-4b, gemini-3.1-flash-image ve gpt-image-2.5. Listede olmayan bir ad 400 döner.

İki kısayol var. model alanını boş bırakırsan ya da adında dall-e geçen bir model yazarsan (örneğin eski koddan kalan dall-e-3) istek Gemini 3.1 Flash Image'a gider. Yani DALL-E için yazılmış bir aracı adresini değiştirerek çalıştırabilirsin.

Seçim kabaca şöyle: çok sayıda ucuz görsel gerekiyorsa FLUX.2 Klein, referans görselle düzenleme ya da genel kullanım için Gemini, en ayrıntılı sonuç için GPT Image 2.5. FLUX.2 Klein referans görsel almaz.

İlk görseli nasıl üretirim?

API anahtarını Anahtarlar sayfasından al ve API_KEY ortam değişkenine koy. En kısa istek şu:

curl https://api.wiozen.com/v1/images/generations \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "gemini-3.1-flash-image", "prompt": "Sabah ışığında bir fincan Türk kahvesi, yakın çekim"}'

Yanıt OpenAI biçimindedir; görsel data[0].b64_json alanında base64 olarak gelir. OpenAI'nin resmi Python kütüphanesi de yalnız base_url değiştirilerek çalışır:

import base64
from openai import OpenAI

client = OpenAI(base_url="https://api.wiozen.com/v1", api_key="sk-gw-...")

result = client.images.generate(
    model="flux-2-klein-4b",
    prompt="Sabah ışığında bir fincan Türk kahvesi, yakın çekim",
    size="1536x1024",
)
with open("kahve.png", "wb") as f:
    f.write(base64.b64decode(result.data[0].b64_json))

Tek istekte n ile en çok 10 görsel isteyebilirsin; daha büyük bir sayı 10'a indirilir. Boş prompt 400 alır. Bağlantı ayrıntıları için OpenAI uyumlu API rehberine, uçların tamamı için belgelere bak.

Görsel başı maliyet ne kadar?

Görseller tokenle değil, model başına sabit bir birim sayısıyla ücretlenir ve bu sayı modelin Modeller sayfasındaki çıktı fiyatıyla çarpılır. Aşağıdaki tutarlar 30 Ekim 2026 itibarıyla geçerli; üç model de o gün resmi fiyatının %30 altında listeleniyordu. Güncel fiyat her zaman Modeller sayfasında.

Hesap Gemini için şöyle: 1.120 × 42 / 1.000.000 = $0,047. Buna her istekte 500 tokenlik sabit bir girdi ücreti eklenir. Bu, 30 Ekim fiyatlarıyla GPT Image 2.5'te yaklaşık $0,002, Gemini'de $0,0002, FLUX.2 Klein'da sıfır. n ile birden çok görsel istersen görsel ücreti o sayıyla çarpılır, girdi ücreti bir kez alınır.

Örnek: bir blog için ayda 300 öne çıkan görsel üretirsen FLUX.2 Klein ile yaklaşık $3, Gemini ile yaklaşık $14, GPT Image 2.5'in yatay boyutuyla yaklaşık $35 ödersin. Model yanıtla birlikte kendi token kullanımını bildirirse ücret tablodaki sabit sayı yerine o kullanımdan hesaplanır.

Görsel üretilemezse ya da bağlantı koparsa ücret alınır mı?

İstek başlarken bakiyenden tahmini tutar ayrılır, görsel sana ulaşınca gerçek tutar yazılır. Model hata verirse ayrılan tutar geri bırakılır. İstemcin yanıtı beklemeden bağlantıyı keserse (zaman aşımı, kapatılan sekme) görsel üretimi de kesilir ve ücret yazılmaz.

Gemini 3.1 Flash Image istediğinde ve Gemini o an yanıt veremezse görseli sırayla FLUX.2 Klein, o da olmazsa GPT Image 2.5 üretir. Ücret görseli üreten modelin fiyatıyla yazılır ve Kullanım sayfasında o modelin adı görünür. Bu yüzden başlarken bakiyenden zincirdeki en pahalı modelin tutarı kadar ayrılır; bakiye buna yetmezse istek 429 alır. FLUX.2 Klein ya da GPT Image 2.5'i doğrudan istersen yedek denenmez.

Anahtarına harcama tavanı koyduysan görsel uçları da o tavana sayılır.

Referans görselle nasıl üretirim?

Var olan bir görseli değiştirmek ya da ona benzer bir görsel üretmek için isteğe image alanı eklersin. Değer görselin base64 metni ya da data:image/png;base64,... biçiminde bir data URI olur. Python kütüphanesinde bu alan extra_body={"image": ...} ile gönderilir.

Referanslı istek Gemini 3.1 Flash Image ya da GPT Image 2.5 ile çalışır. Gemini'ye referanslı istek gönderdiğinde yedek zincirde FLUX.2 Klein atlanır ve sıradaki model GPT Image 2.5 olur. Tam örnek belgelerde var.

Sık sorulan sorular

Bir anahtar oluştur, yukarıdaki curl komutunu çalıştır ve fiyatları Modeller sayfasında karşılaştır.

Hesabını aç

Diğer rehberler: Türkiye'den kredi kartı olmadan yapay zekâ API'si nasıl kullanılır? · OpenAI uyumlu bir API mevcut bir araca nasıl bağlanır? · Yapay zekâ API maliyeti nasıl hesaplanır? · Yapay zekâ API anahtarım sızdıysa ne yapmalıyım? · Yapay zekâ API'si neden 429 hatası veriyor, nasıl düzeltilir? · Uzun yanıt bekleyen API isteği neden zaman aşımına düşer: akışlı mı, akışsız mı? · Anthropic Messages API mı, OpenAI Chat Completions mı: hangisini kullanmalıyım? · Bağlam penceresi (context window) nedir, 1 milyon token ne işe yarar? · Hangi yapay zekâ modelini seçmeliyim: fiyat, bağlam ve kaliteye göre karar · Düşünen (reasoning) model neden boş cevap döner, düşünme tokenları neden ücretlenir? · API bakiyem neden beklediğimden hızlı bitiyor? Harcamayı istek istek takip etmek · Bir web sayfası yapay zekâya vermek için Markdown'a nasıl çevrilir? · WordPress'te yapay zekâyla otomatik makale nasıl yazdırılır? · Blog için RSS ve Google Trends'ten konu nasıl bulunur? · Yapay zekâyla yazılan içerik Google'da ve yapay zekâ yanıtlarında görünür mü? · WordPress'te yapay zekâyla yazılan makalelere iç bağlantı nasıl ekletilir? · WordPress'te her yazıya birbirine benzemeyen öne çıkan görsel yapay zekâyla nasıl ürettirilir? · Yapay zekâya blog yazısı yazdırırken içerik tarifi (brief) nasıl yazılır? · Yemek tarifi sitesine yapay zekâyla tarif yazdırırken nelere dikkat etmeli? · WordPress eklentisini yapay zekâ API hesabına bağlarken çıkan hatalar nasıl çözülür? · WordPress'te yapay zekâ yazı botu neden yarıda kalıyor? "Tur takıldı" uyarısı ve LiteSpeed · WordPress'te otomatik yazılar neden geç çıkıyor? WP-Cron ve gerçek sunucu cron'u · Yapay zekâ yazı botuyla İngilizce ya da başka dilde blog yazısı nasıl yazdırılır? · "İçerik Botu yazı üretemiyor" uyarısı ne demek? Bot günlüğündeki satırları okumak