Google'ın Gemini API'si üzerinden `gemini-3.6-flash` model kimliğiyle Gemini 3.6 Flash'ı çağırırsınız. İşin özü bu. Google, 21 Temmuz 2026'da Flash yenilemesini yayınladı ve 3.6 Flash işgücü katmanıdır: 3.5 Flash'tan daha ucuz çıktı, 1M token bağlam penceresi ve metin, resim, video, ses ve PDF girdileri sunar. Bu kılavuz sizi sıfırdan test edilmiş bir isteğe götürecektir. Bir anahtar alacak, curl ve Python'da ilk çağrınızı yapacak, önemli parametreleri öğrenecek ve bir regresyon testi kurarak yayına aldıktan sonra çağrının çalışmaya devam etmesini sağlayacaksınız.
Başlamadan önce ihtiyacınız olanlar
Üç şey var ve hiçbirine başlamak için para ödemeniz gerekmez.
- Bir Google hesabı. Anahtar almak için bu şekilde oturum açarsınız.
- Bir Gemini API anahtarı. Google AI Studio'dan ücretsizdir ve bir sonraki bölüm bunu ele almaktadır.
- Bir HTTP isteği göndermenin bir yolu. curl herhangi bir terminalden çalışır. Kod yazmayı tercih ediyorsanız Python çalışır. Tüm bunların üzerinde bir kullanıcı arayüzü istiyorsanız Apidog gibi bir API istemcisi de kullanabilirsiniz. Üçünü de göstereceğiz.
Önceden herhangi bir faturalandırma kurulumu gerekmez. Ücretsiz katman AI Studio üzerinden çalışır ve hız sınırlıdır, bu nedenle kayıtlı bir kart olmadan test yapabilirsiniz. Bu sınırlamalar hakkında daha fazla bilgi aşağıdadır.
Bir Gemini API anahtarı edinin
Google AI Studio'ya gidin ve Google hesabınızla oturum açın. "API anahtarını al"a, ardından "API anahtarı oluştur"a tıklayın. Size verilen dizeyi kopyalayın ve güvenli bir yere saklayın. Buna bir şifre gibi davranın: anahtarı olan herkes hesabınızdan harcama yapabilir.
Anahtarı istemci tarafı koduna yapıştırmayın ve bir depoya kaydetmeyin. Bunun yerine bir ortam değişkeni olarak ayarlayın:
export GEMINI_API_KEY="your_key_here"
Resmi Python SDK'sı bu değişkeni kendi başına okur, bu da sırrı kaynak dosyalarınızdan uzak tutar. Kanonik kurulum adımları için Google'ın Gemini API belgelerine bakın.
İlk API çağrınızı yapın
REST uç noktası, modelin generateContent yöntemine bir POST isteğidir. İşte curl'de nasıl yapıldığı:
curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-3.6-flash:generateContent" \
-H "x-goog-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-X POST \
-d '{
"contents": [
{
"parts": [
{"text": "Explain how APIs work"}
]
}
]
}'
Anahtar x-goog-api-key başlığına gider. Gövde bir contents dizisidir; her girişin bir parts dizisi vardır; buradaki her bölüm bir text dizesidir. Bu iç içe yapı tek bir istem için karmaşık görünebilir, ancak daha sonra metni görüntüler ve dosyalarla tek bir istekte karıştırmanıza olanak tanıyan aynı şekildir.
Python'ı mı tercih edersiniz? SDK'yı pip install google-genai ile kurun, ardından:
from google import genai
client = genai.Client() # reads GEMINI_API_KEY from the environment
resp = client.models.generate_content(
model="gemini-3.6-flash",
contents="Explain how APIs work",
)
print(resp.text)
İstemci GEMINI_API_KEY'i kendisi alır, böylece kodunuzda bir anahtar bulunmaz. resp.text üretilen yanıtı tutar. Bu, beş satırda çalışan bir çağrıdır.
Kaputun altında, API JSON döndürür. Üretilen metin candidates[0].content.parts[0].text adresinde bulunur. Şimdi buna dikkat etmekte fayda var, çünkü bu çağrıyı daha sonra kılavuzda bir teste dönüştürdüğünüzde iddia edeceğiniz tam alan budur.
Bilmeye değer önemli parametreler
Basit istek çalışır, ancak birkaç ayar geri aldığınızı değiştirir.
- Sistem talimatı. Tüm konuşmaya uygulanan, kullanıcı isteminden ayrı tutulan bir kişilik veya kural kümesi ayarlayın. Bunu "Yalnızca JSON olarak yanıtla" veya "Siz kısa bir kod inceleyicisiniz" gibi durumlar için kullanın. Tonu ve formatı, talimatları her mesajın içine sıkıştırmaktan çok daha güvenilir bir şekilde yönlendirir.
- Maksimum çıktı tokenları. Yanıtın uzunluğunu sınırlayın. 3.6 Flash 64 bin adede kadar çıktı tokenı üretebilir, bu nedenle uzun üretimler için sınırı yükseltin ve maliyet ile gecikmeyi kontrol etmek istediğinizde düşürün.
- Çok modlu girdiler. Model, aynı çağrıda metin, görüntüler, video, ses ve PDF'leri okur. Bunları, metninizin yanına
partsdizisinde ek girişler olarak eklersiniz. Çıktı yalnızca metindir, bu yüzden bunu birçok farklı türde girdi alıp kelimeler çıkaran bir şey olarak düşünün. Bağlam penceresi, uzun bir PDF veya tam bir video transkripti için yer olan 1M'ye kadar girdi tokenı tutar. - Düşünme ve muhakeme. 3.6 Flash zorlu istemlere yanıt vermeden önce muhakeme yapar. Çok adımlı çalışmayı geliştiren şey budur ve çıktı fiyatının düşünme tokenlarını içermesinin nedeni budur (bununla ilgili daha fazla bilgi bir sonraki bölümde). Derinliği hızla değiştirmek istediğinizde muhakeme çabasını ayarlayabilirsiniz.
Tüm parametre listesi Gemini API belgelerinde bulunur. Alan adlarını tahmin etmeyin; belgeler doğruluk kaynağıdır ve API güncellendiğinde onlar da güncellenir.
Fiyatlandırma ve ücretsiz katman
Gemini 3.6 Flash, 1M girdi tokenı başına 1,50 ABD doları ve 1M çıktı tokenı başına 7,50 ABD doları maliyetlidir. Bu çıktı oranı, 3.5 Flash'ın ücretlendirdiği 9,00 ABD dolarından bir düşüştür ve 3.6 Flash ayrıca aynı görevde yaklaşık %17 daha az çıktı tokenı üretme eğilimindedir, bu da tasarrufları birleştirir. İçselleştirilmesi gereken bir ayrıntı: çıktı fiyatı düşünme tokenlarını içerir. Modelin dahili muhakemesi çıktı oranı üzerinden faturalandırılır, bu nedenle yoğun muhakemeyi tetikleyen bir istem, görünen yanıt uzunluğunun önerdiğinden daha pahalıya mal olabilir. Buna bütçe ayırın. Tüm matematiği Gemini 3.6 Flash fiyatlandırma kılavuzumuzda ayrıntılarıyla açıklıyoruz.
Ücretsiz katman AI Studio üzerinden çalışır ve gerçektir, ancak hız sınırlıdır: dakika ve gün başına sınırlı istekler vardır ve Google, ücretsiz katman verilerini ürünlerini geliştirmek için kullanabilir. Üretim trafiği için değil, prototipleme için tasarlanmıştır. Öğrenme ve test için bolca yeterlidir. Ne kadar esnediğini görmek için Gemini 3.6 Flash'ı ücretsiz olarak nasıl kullanacağınızı okuyun. Onu aştığınızda, faturalandırmayı etkinleştirirsiniz ve aynı anahtar çalışmaya devam eder, kod değişikliği gerekmez.
Gemini API'yi Apidog'da test edin ve hata ayıklayın
Curl, çağrının bir kez çalıştığını kanıtlar. Google'ın bir yanıt alanını ne zaman değiştirdiğini, anahtarınızın ne zaman sona erdiğini veya bir dağıtımın isteği sessizce bozduğunu size söylemez. Bunun için kaydedilmiş, tekrarlanabilir bir test istersiniz. İşte Apidog'un iş akışında yerini kazandığı yer burasıdır.
Apidog bir API istemcisi ve test platformudur. Gemini çağrısı için akış, baştan sona şöyle:
- İsteği oluşturun.
https://generativelanguage.googleapis.com/v1beta/models/gemini-3.6-flash:generateContentURL'si ile yeni bir POST isteği ekleyin. Daha önceki JSON gövdesini istek gövdesine yapıştırın. - Anahtarı bir ortam değişkeninde saklayın. Bir Apidog ortamına
GEMINI_API_KEYadında bir değişken ekleyin, ardındanx-goog-api-keybaşlığında{{GEMINI_API_KEY}}olarak referans gösterin. Sır paylaşılan isteğin dışında kalır ve çağrının kendisine dokunmadan ortam başına (dev, staging, prod) anahtarları değiştirebilirsiniz. - Onaylamalar ekleyin. İstek çalıştıktan sonra JSON yanıtını onaylayın: durum 200'dür ve
candidates[0].content.parts[0].textmevcuttur ve boş değildir. Artık başarılı bir çalışma, API'nin yalnızca bir şeyler döndürmekle kalmayıp gerçekten yanıt verdiğini gösterir. - Kaydedin ve zamanlayın. İsteği bir koleksiyonda tutun ve bir regresyon testi olarak zamanlayın. Bir zamanlayıcıda veya CI içinde çalıştırın, böylece kullanıcılarınızdan önce Gemini çağrısının ne zaman düzgün çalışmayı durdurduğunu anında öğreneceksiniz.
Apidog'u indirin ve bu testi birkaç dakika içinde çalışır hale getirebilirsiniz. İşte dürüst uyum burada: Apidog modeli çalıştırmaz, uygulamanızın beklediği şekilde API'nin yanıt vermeye devam ettiğinden emin olur.
Sık karşılaşılan hatalar ve çözümleri
Üç hata, başlangıçta karşılaşacağınız çoğu şeyi kapsar.
- 401 Yetkilendirilmemiş (geçersiz anahtar). Anahtar yanlış, iptal edilmiş veya başlıktan eksik.
x-goog-api-key'in AI Studio'dan gelen tam dizeyi içerdiğini ve ortam değişkeninizin gerçekten çözümlendiğini kontrol edin. Sondaki bir boşluk veya genişletilmemiş bir{{GEMINI_API_KEY}}genellikle suçludur. - 429 Çok Fazla İstek (oran sınırı). Ücretsiz katmanın dakika başına veya gün başına sınırına ulaştınız. İstek hızını yavaşlatın, geri çekilme ile yeniden deneme ekleyin veya tavanı yükseltmek için faturalandırmayı etkinleştirin. Sıkı test döngüleri bunu hızlıca tetikler.
- 404 Bulunamadı (model bulunamadı). Bu neredeyse her zaman model kimliğinde bir yazım hatasıdır. Tam olarak
gemini-3.6-flasholmalıdır.gemini-3.5-flashdeğil,gemini-flash-3.6değil. Aynı sürümdeki Lite katmanı 3.5 serisindeki farklı bir model olangemini-3.5-flash-liteolduğundan, aralarındaki bağlantıları karıştırmayın.
Sıkça Sorulan Sorular
Gemini 3.6 Flash için tam model kimliği nedir? gemini-3.6-flash'tir. Bunu SDK'da model adı olarak ve REST URL yolunda :generateContent'ten hemen önce kullanın.
Gemini 3.6 Flash API'si ücretsiz mi? AI Studio aracılığıyla ücretsiz bir katman mevcuttur ve hız sınırlıdır. Prototipleme ve öğrenme için iyidir. Üretim trafiği için faturalandırmanın etkinleştirilmesi gerekir. Ayrıntılar için ücretsiz olarak nasıl kullanacağınızı görün.
Modele ne gönderebilirim? 1M tokenlık bağlam penceresine kadar metin, görüntüler, video, ses ve PDF. Çıktı sadece metindir.
Faturam neden görünen yanıtlardan daha yüksek geldi? 1M token başına 7,50 dolarlık çıktı fiyatı, modelin düşünme tokenlarını içerir. Yoğun muhakeme gerektiren istemler, ekranın gösterdiği yanıt uzunluğundan daha fazla faturalandırılır.
Bu, eski Gemini 3.5 Flash API'siyle aynı mı? Çağrı şekli aynıdır, bu nedenle Gemini 3.5 API'sini kullandıysanız, model kimliğini değiştirmeniz yeterlidir. 3.6 Flash, çıktı fiyatını düşürür ve aynı iş için daha az çıktı tokenı kullanır.
Aynı anahtarı curl, Python ve Apidog'da kullanabilir miyim? Evet. AI Studio'dan alınan tek bir anahtar bunların hepsinde çalışır. Her araçta doğrudan kodlamak yerine bir ortam değişkeninde tutun ve böylece tek bir yerden döndürebilir veya iptal edebilirsiniz.
Bundan sonra nereye gitmeli?
Bir anahtarınız, curl ve Python'da çalışan bir çağrınız, önemli parametreleriniz ve uç noktayı izleyen kaydedilmiş bir regresyon testiniz var. Ücretsiz katmandan başlayın, anahtarınızı bir ortam değişkeninde tutun ve temel bilgilerin ötesindeki her şey için resmi belgelere başvurun. Çağrı, uygulamanızın bağlı olduğu bir şeye dönüştüğünde, sessiz bir API değişikliğinin kullanıcılarınıza ilk ulaşmaması için onu bir Apidog testiyle sarmalayın.