Entegrasyon rehberleri · 2026-09-22

Gemini 2.5 Flash Image: adım adım düzenleme akışı ve function calling etiketinin anlamı

google/gemini-2.5-flash-image ile metinden görsel üretip aynı görseli ardışık talimatlarla nasıl düzenleyeceğinizi, her adımın nasıl fiyatlandığını ve katalogdaki function calling etiketinin görsel ucunda ne anlama geldiğini anlatır.

Gemini 2.5 Flash Image'in önce bir görsel ürettiğini, ardından o görseli referans olarak alan yeni bir talimatla düzenlediğini gösteren akış şeması.

Üretim ve düzenleme aynı uçta

google/gemini-2.5-flash-image'in katalog açıklaması, metinden görsel üretimi ile ardışık düzenlemeyi aynı akışta birleştirmek isteyen ekipler için uygun olduğunu belirtir. LLMTR'de ikisi de `/v1/images/generations` ucundan yapılır; ayrı bir düzenleme API'sine geçmeniz gerekmez.

Bu uç konuşma geçmişi tutmaz: her istek yalnızca o istekte gönderdiğiniz `prompt` ve referans görsellerle işlenir. Bir görseli düzenlemeye devam etmek için bir önceki adımın çıktısını `image_url` (veya yüklediğiniz dosya için `file_id`) alanında tekrar gönderip 'arka planı maviye çevir' gibi yeni talimatı `prompt` olarak yazarsınız. Referans görseli göndermeden atılan bir takip isteği, önceki görseli düzenlemez; sıfırdan yeni bir görsel üretir.

  • Adım 1: `prompt` ile ilk görseli üretin.
  • Adım 2: dönen görseli `image_url` veya `file_id` ile referans olarak ekleyin, düzenleme talimatını `prompt` olarak yazın.
  • Her yeni düzenleme adımında son görseli yeniden referans olarak gönderin.

Her düzenleme adımı nasıl fiyatlanır

Fiyatlandırma üç kaleme ayrılır: girdi metni 1M token başına 0,30$, girdi görseli 1M token başına 0,30$ ve çıktı görseli görsel başına 0,039$. Girdi görseli sabit bir görsel başı ücret değildir; referans görselin kaç token'a karşılık geldiğine göre hesaplanır, bu yüzden bir referans görselin maliyeti tipik olarak bir sentin çok altında kalır.

Bir düzenleme döngüsünde her adım yeni bir istektir ve kendi girdi ve çıktı maliyetini taşır. Çok adımlı bir akışın toplam maliyetinde baskın kalem genellikle adım başına 0,039$'lık çıktı görselidir; bütçeyi beklenen adım sayısı ile bu tutarı çarparak, üzerine metin ve referans görsel token'larını ekleyerek hesaplayın.

Katalogdaki function calling etiketi görsel ucunda kullanılamaz

Modelin katalog yetenek listesinde `function_calling` görünür, ama `/v1/images/generations` ucu `tools` ve `tool_choice` alanlarını kabul etmez; bu uç üzerinden bir görsel üretimi sırasında araç çağıran bir akış kuramazsınız. Örneğin bir ürün kataloğundan referans görsel çekmeniz gerekiyorsa, bu adımı kendi uygulamanızda yapıp bulduğunuz görseli `image_url` olarak isteğe ekleyin.

Katalog açıklaması modeli hızlı iterasyon, ürün görselleri ve yaratıcı yardımcı senaryoları için konumlar; bir kullanıcının bir görseli birkaç ardışık talimatla ince ayarladığı bir tasarım aracında veya e-ticaret görsel düzenleyicisinde yukarıdaki referans görselli akış doğrudan kullanılabilir.

Sık sorulan sorular

Bir görseli düzenlemek için önceki görseli tekrar göndermem gerekir mi?

Evet. `/v1/images/generations` konuşma geçmişi tutmaz; her düzenleme isteğinde önceki görseli `image_url` veya `file_id` ile referans olarak göndermeniz gerekir. Referans olmadan gönderilen istek yeni bir görsel üretir.

Görsel üretirken function calling kullanabilir miyim?

Hayır. Görsel ucu `tools` alanını kabul etmez. Araçla yapmak istediğiniz adımı (örneğin referans görsel bulmayı) kendi uygulamanızda yapıp sonucu isteğe referans görsel olarak ekleyin.

İlgili yazılar