Gemini yapay zeka (AI) modelleri; metin, resim ve ses gibi çeşitli giriş veri türlerini işlemek için tasarlanmıştır. Bu modeller birden fazla veri türü veya modu işleyebildiğinden Gemini modelleri çok formatlı modeller olarak adlandırılır ya da çok formatlı özelliklere sahip olarak açıklanır.
Bu sayfada, Gemini API'si için istemlerle medya dosyalarını kullanmayla ilgili kılavuzlar ve en iyi uygulamalar yer almaktadır. Medya dosyalarını yüklemek ve istemlerinize eklemek için Gemini Files API'yi kullanma hakkında bilgi edinmek üzere Vision, Ses ve Belge işleme kılavuzlarına bakın.
Medya dosyalarını istemlerle kullanma
İstemlerinizde çeşitli veri türlerini kullanabilmek, Gemini API ile hangi görevleri üstlenebileceğiniz konusunda daha fazla esneklik sağlar. Örneğin, modele lezzetli bir yemeğin fotoğrafını gönderip yemek hakkında kısa bir blog yazmasını isteyebilirsiniz.
| İstem | Yanıt |
|
Bu resme dayalı kısa ve ilgi çekici bir blog yayını yazın. Fotoğraftaki yemeğin açıklamasını içermeli ve yemek hazırlama deneyimimden bahsetmelidir. 
|
Yemek hazırlamak, zaman ve para tasarrufu yapmanın yanı sıra daha sağlıklı beslenmenize de yardımcı olabilir. Bu yemek, önceden kolayca hazırlanabilen sağlıklı ve lezzetli bir yemeğin mükemmel bir örneğidir. Bu yemekte kahverengi pirinç, kavrulmuş sebzeler ve teriyaki tavuk bulunur. Kahverengi pirinç, uzun süreli enerji veren sağlıklı ve karmaşık bir karbonhidrattır. Kavrulmuş sebzeler, günlük vitamin ve mineral ihtiyacınızı karşılamak için mükemmel bir seçenektir. Teriyaki tavuk ise lezzetli ve protein açısından zengin bir alternatiftir. Bu yemeğin hazırlanması da çok kolaydır. Kahverengi pirinci pişirin, sebzeleri kızartın ve tavuk teriyakiyi pişirin. Her şey piştikten sonra, hazırladığınız yemekleri porsiyonlara ayırıp buzdolabında saklayın. Ardından, bir kap alıp yoğun sabahlara hazırlanabilirsiniz. Önceden kolayca hazırlanabilen sağlıklı ve lezzetli bir yemek arıyorsanız bu yemek mükemmel bir seçenektir. Besin değeri ve lezzetiyle sizi doyurup memnun edecek. Sağlıklı ve lezzetli yemekler hazırlamanız dileğiyle. |
Medya ile istemde bulunma stratejileri
Medya dosyalarını kullanan istemlerden istediğiniz çıktıyı alma konusunda sorun yaşıyorsanız istediğiniz sonuçları elde etmenize yardımcı olabilecek bazı stratejiler vardır. Aşağıdaki bölümlerde, çoklu giriş kullanan istemleri iyileştirmeye yönelik tasarım yaklaşımları ve sorun giderme ipuçları verilmiştir.
Aşağıdaki en iyi uygulamaları izleyerek çoklu modal istemlerinizi iyileştirebilirsiniz:
-
İstem tasarımıyla ilgili temel bilgiler
- Talimatlarınızda net olun: Yanlış anlaşılmaya çok az yer bırakan net ve kısa talimatlar oluşturun.
- İsteminize birkaç örnek ekleyin: Ne elde etmek istediğinizi göstermek için gerçekçi birkaç örnek kullanın.
- Adım adım ayrıntılı olarak inceleyin: Karmaşık görevleri yönetilebilir alt hedeflere ayırarak modele süreçte yol gösterin.
- Çıkış biçimini belirtin: İsteminizde, çıkışın markdown, JSON, HTML gibi istediğiniz biçimde olmasını isteyin.
- Tek resimli istemler için resminizi önceye koyun: Gemini, resim ve metin girişlerini herhangi bir sırada işleyebilir. Ancak tek resim içeren istemlerde, resmin metin isteminden önce yerleştirilmesi daha iyi performans sağlayabilir.
-
Çoklu modal isteminizle ilgili sorunları giderme
- Model, resmin ilgili kısmından bilgi almıyorsa: İstemin bilgi almasını istediğiniz resmin hangi yönlerini belirtecek ipuçları bırakın.
- Model çıkışı çok genelse (resme yeterince uyarlanmamışsa): İstemin başında, görev talimatlarını vermeden önce modelden resimleri açıklamasını veya resimdeki öğelere değinmesini istemeyi deneyin.
İstem tasarımıyla ilgili temel bilgiler
Bu bölümde, önceki bölümde listelenen en iyi uygulamalar ayrıntılı olarak açıklanmaktadır.
Not: Aşağıdaki Gemini örneklerinden elde edilen model sonuçları, çalıştırmadan çalıştırmaya değişiklik gösterebilir.
Talimatlarınızda net olun
İstemler en başarılı sonuçları net ve ayrıntılı olduklarında verir. Belirli bir çıktıyı hedeflediyseniz istediğiniz çıktıyı elde etmek için bu koşulu isteminize eklemeniz daha iyi olur.
Bazen bir istem, yazan kişi için net görünse de aslında yeterince ayrıntılı değildir. Model davranışını özelleştirmek için isteminizin nasıl (yanlış) yorumlanabileceğini göz önünde bulundurun ve verdiğiniz talimatların net ve anlaşılır olduğundan emin olun. Yanlış anlaşılmaya yer vermemek için
Bir havaalanı tabelasının yer aldığı bu resimde, modelden yalnızca "bu resmi açıklamasını" istemek genel bir açıklama oluşturabilir. Modelin, resimdeki saati ve şehri ayrıştırması gerekiyorsa bu isteği doğrudan isteminize ekleyebilirsiniz.
| İstem | Model yanıtı |
|---|---|
 Bu resmi tanımlayın. |
Resimde bir havalimanının gelen ve giden uçuşlar tabelası gösteriliyor. |
| Güncellenen istem | İyileştirilmiş yanıt |
|---|---|
Bu resimde gösterilen havaalanı panosunda yer alan saati ve şehri bir listeye ayırın. |
Birkaç örnek ekleyin
Gemini modeli, istediğiniz çıktıyı anlamak için örnek olarak kullanabileceği birden fazla girişi kabul edebilir. Bu örnekleri eklemek, modelin kalıpları belirlemesine ve verilen resimler ile yanıtlar arasındaki ilişkiyi yeni örneğine uygulamasına yardımcı olabilir. Buna "az sayıda örnekle" öğrenme denir.
Aşağıdaki örnekte, ilk çıkış cümle biçiminde yazılmıştır ve ülkeyi (Brezilya) da içerir. Çıktının farklı bir biçimde veya tarzda olmasını ve ülkenin değil, yalnızca şehrin gösterilmesini istediğinizi varsayalım. İsteminize birkaç örnek eklemek, modelin istediğiniz şekilde yanıt vermesini sağlayabilir.
| İstem | Model yanıtı |
|---|---|
 Simge yapıyla birlikte şehri belirleyin. |
Bu simge, Brezilya'nın Rio de Janeiro kentindeki Kurtarıcı İsa heykelidir. |
| Güncellenen istem | İyileştirilmiş yanıt |
|---|---|
|
Simge yapıyla birlikte şehri belirleyin. 
|
şehir: Roma, simge yapı: Kolezyum. |
|
şehir: Pekin, simge yapı: Yasak Şehir |
|
|
şehir: Rio de Janeiro, simge yapı: Kurtarıcı İsa heykeli |
Adım adım açıklama
Hem görsel anlama hem de mantık yürütme gerektiren karmaşık görevler için görevi daha küçük ve daha basit adımlara bölmek yararlı olabilir. Alternatif olarak, isteminizde modelden doğrudan "adım adım düşünmesini" istemeniz de etkili olabilir.
| İstem | Model yanıtı |
|---|---|
 When will I run out of toilet paper? |
Yakında yalnızca 3 rulonuz kalacak. |
| Güncellenen istem | İyileştirilmiş yanıt |
|---|---|
|
|
Matematik problemleri veya diğer sözel problem türleri, modelden adım adım düşünmesini istemek için mükemmel adaylardır.
| İstem | Yanıt |
|---|---|
Dizinin 4. terimi nedir? |
-135 |
Modelden gelen yanıt yanlış. Bu sorunu iyileştirmenin bazı yolları, istemi yanıtlamadan önce modelden sorunu ayrıştırmasını istemektir.
| İstem | Yanıt |
|---|---|
Öncelikle resimdeki formülü ayrıştırın. Ardından, formüle göre "dizindeki 4. terim nedir?" sorusunu yanıtlayın. |
Sonucu genişletmek için tıklayın$$ b(n) = b(n-1) * (-3) $$ $$ b(1) = 15 $$
$$ b(4) = b(4-1) * (-3) $$ $$ b(4) = b(3) * (-3) $$ $$ b(3) = b(3-1) * (-3) $$ $$ b(3) = b(2) * (-3) $$ $$ b(2) = b(2-1) * (-3) $$ $$ b(2) = b(1) * (-3) $$ $$ b(2) = 15 * (-3) $$ $$ b(2) = -45 $$ $$ b(3) = b(2) * (-3) $$ $$ b(3) = -45 * (-3) $$ $$ b(3) = 135 $$ $$ b(4) = b(3) * (-3) $$ $$ b(4) = 135 * (-3) $$ $$ b(4) = -405 $$ Bu nedenle, dizinin 4. terimi -405'tir. |
Bu model yanıtı doğrudur. Yanıtı daha da basitleştirmek için modelden adım adım düşünmesini isteyebilirsiniz.
| Güncellenen istem | İyileştirilmiş yanıt |
|---|---|
Dizinin 4. terimi nedir? Adım adım düşünün. |
İlk terim 15'tir. İkinci terim b(1) * (-3) = 15 * (-3) = -45'tir. Üçüncü terim b(2) * (-3) = -45 * (-3) = 135'tir. Dördüncü terim b(3) * (-3) = 135 * (-3) = -405'tir. |
Çıkış biçimini belirtmeyi deneyin
Özellikle model çıktısının bir yayın sonrası görev tarafından işlenmesi gerekiyorsa model çıktısının belirli bir biçimde (ör. markdown, JSON, HTML) olması gerektiği yaygın bir sorundur. İstemde modele bu biçimte çıkış vermesini talimat vererek bu biçimde çıkış üretmeyi deneyebilirsiniz. Aşağıda iki örnek verilmiştir:
| İstem | Model yanıtı |
|---|---|
 Bu resimdeki tabloyu markdown biçiminde ayrıştırma |
| Konu | Durum | Zaman | Başlangıç tarihi | Son tarih | | ------- | ------ | ---- | --------- | ------ | | Matematik | Tamamlandı | 1,5 saat | 29/11/2023 | 1/12/2023 | | Coğrafya | Tamamlandı | 30 dk | 2/12/2023 | 4/12/2023 | | Fizik | Devam ediyor | 2 saat | 3/12/2023 | 5/12/2023 | | Biyoloji | Başlanmadı | 6 saat | 2/11/2016 | 6/12/2023 | |
| İstem | Model yanıtı |
|---|---|
Aşağıdaki tüm özelliklerin listesini sağlayın: JSON biçiminde malzemeler, yemek türü, vejetaryen olup olmadığı |
|
Tek resimli istemler için resminizi öne çıkarın
Gemini, bir istemdeki resim ve metni herhangi bir sırada yorumlayabilir. Ancak metin isteminden önce tek bir resim yerleştirmek daha iyi sonuçlara yol açabilir. Aşağıdaki örneklerde, her istemde metinden önce resmin geldiğini göreceksiniz.
Çoklu formatlı isteminizle ilgili sorunları giderme
Yararlı bir yanıt alamıyorsanız isteminizde sorun gidermeniz gerekebilir. Deneyebileceğiniz birkaç stratejiyi aşağıda bulabilirsiniz.
Model, resmin ilgili kısmından bilgi almıyorsa
Daha ayrıntılı bir yanıt almak için istemin yanıtını belirlerken hangi resim özelliklerinden bilgi almasını istediğinizi belirtebilirsiniz.
| İstem | Model yanıtı |
|---|---|
 Bu bez bir bebek için kaç gün dayanır? |
Bezler 198 gün boyunca kullanılabilir. |
| Güncellenen istem | İyileştirilmiş yanıt |
|---|---|
|
Bu bezlerden ne kadar süre boyunca kullanabilirim? Çocuğun yaşını belirlemek için kutuda gösterilen ağırlığı ve kutudaki toplam bebek bezi sayısını kullanın. Toplam sayıyı çocuğun günde kaç bez kullandığına bölün. |
Kutuda 198 bebek bezi var. Kutuda, bebek bezinin 10-17 kg ağırlığındaki çocuklar için olduğu belirtiliyor. Bu ağırlık aralığındaki ortalama çocuk muhtemelen 1-2 yaş arasındadır. 2 yaşındaki bir çocuk genellikle günde 6 bez kullanır. Bu nedenle, bez yaklaşık 33 gün (198/6) sürer. |
Model çıkışı çok genelse ve resim girişine yeterince uyarlanmamışsa
Modelin yanıtını görüntülere göre uyarlamasına yardımcı olmak için mantık yürütme görevini gerçekleştirmeden önce resimleri açıklamasını isteyin.
| İstem | Model yanıtı |
|---|---|
Bu resimlerin ortak noktası nedir? |
Dört resim de manzara fotoğrafı örneğidir. |
| Güncellenen istem | İyileştirilmiş yanıt |
|---|---|
|
Öncelikle her bir resimde ne olduğunu ayrıntılı olarak açıklayın. Bu resimlerin ortak noktası nedir? |
İlk resimde, bavulunu toplayan bir kişi gösterilmektedir. İkinci resimde, bir alışveriş merkezindeki boş bir koridor gösterilmektedir. Üçüncü resimde bir rulo tuvalet kağıdı gösterilmektedir. Dördüncü resimde karanlık ve fırtınalı bir deniz gösteriliyor. Bu resimlerin ortak noktası, hepsinin geçiş alanlarına örnek olmasıdır. Liminal alanlar, iki yer veya durum arasında kalan yerler ya da durumlara verilen addır. Bu tür içerikler genellikle belirsizlik veya muğlaklık hissiyle karakterize edilir. İlk resimde, kişinin evden seyahate gittiği gösteriliyor. İkinci resimde, iki mağaza arasındaki koridor gösterilmektedir. Üçüncü resimde, banyoyu temsil edebilecek bir tuvalet kağıdı var. Banyolar, özel ve kamusal alanlar arasında geçiş alanıdır. Dış dünyaya girmeye veya dış dünyadan çıkmaya hazırlandığımız bir yerdir. Dördüncü resimde, denizin sakin ve fırtınalı olduğu durumlar gösterilmektedir. Liminal alanlar hem heyecan verici hem de rahatsız edici olabilir. Yeni başlangıçların veya sonların yeri olabilir. Bu yerler, düşünmek veya harekete geçmek için ideal olabilir. |
Modelden, resimdeki öğeleri referans olarak kullanmasını açıkça istemeyi de deneyebilirsiniz.
| Güncellenen istem | İyileştirilmiş yanıt |
|---|---|
|
Bu resimlerin ortak noktası nedir? Yanıtınızda resimlerde bulunan öğelere referans verin. |
Resimlerin tümü seyahatle ilgilidir. İlk resimde bavulunu toplayan bir kişi, ikinci resimde bir alışveriş merkezindeki boş bir koridor, üçüncü resimde bir tomar tuvalet kağıdı ve dördüncü resimde karanlık ve fırtınalı bir deniz gösterilmektedir. Bu görsellerin tümü seyahatle ilgilidir çünkü kullanıcıların seyahat ederken ihtiyaç duyduğu veya kullandığı şeylerdir. İlk resimde, seyahate çıkan bir kişinin bavulunu topladığı görülüyor. İkinci resimde, insanların genellikle seyahatleri için alışveriş yaptıkları bir alışveriş merkezindeki boş bir koridor gösteriliyor. Üçüncü resimde, insanların seyahat ederken sıklıkla kullandığı bir ürün olan bir tomar tuvalet kağıdı gösterilmektedir. Dördüncü resimde, seyahat edenlerin sıklıkla karşılaştığı karanlık ve fırtınalı bir deniz gösteriliyor. |
Resimlerden oluşturulan reklam öğeleri için de aynı ipuçları geçerlidir. Aşağıdaki tavşan örneğinde, modelden resme ait unsurları açıkça eklemesini istemek çıktıyı iyileştirebilir.
| İstem | Model yanıtı |
|---|---|
Bana bu resimle ilgili bir şiir yazabilir misin? |
Küçük tavşan, çok yumuşak ve kahverengi, Yeşil ve tatlı otları kemirirsin, |
| Güncellenen istem | İyileştirilmiş yanıt |
|---|---|
|
Bana bu resimle ilgili açıklayıcı ve dramatik bir şiir yazabilir ve konumu ekleyebilir misiniz? |
Yeşil çimenlikteki küçük tavşan, Is it the ocean blue, Küçük tavşan, doğruyu söyle, Belki de her şeyin büyüklüğündendir, Küçük tavşan, ne hayal ediyorsun acaba? Ne olursa olsun küçük tavşan, |
İstemdeki hangi kısmın başarısız olduğuyla ilgili sorunları giderme
Bir istemin başarısız olmasının nedeni, modelin başta resmi anlamaması mı yoksa resmi anlamış ancak sonrasında doğru mantık adımlarını uygulamaması mı olduğunu anlamak zor olabilir.
Bu nedenler arasından hangisinin geçerli olduğunu öğrenmek için modelden resimdeki öğeleri açıklamasını isteyin.
Aşağıdaki örnekte, model çay ile birlikte şaşırtıcı görünen bir atıştırmayla (ör. patlamış mısır) yanıt verirse modelin, resmin çay içerdiğini doğru şekilde algılayıp algılamadığını belirlemek için önce sorun giderme adımlarını uygulayabilirsiniz.
| İstem | Sorun giderme istemi |
|---|---|
 1 dakikada hazırlayabileceğim ve bu yemeğin yanında sunabileceğim bir atıştırmalık var mı? |
Bu resimde ne olduğunu açıklayın. |
Diğer bir strateji de modelden gerekçesini açıklamasını istemektir. Bu, mantığın hangi kısmında (varsa) sorun olduğunu belirlemenize yardımcı olabilir.
| İstem | Sorun giderme istemi |
|---|---|
1 dakikada hazırlayabileceğim ve bu yemeğin yanında sunabileceğim bir atıştırmalık var mı? |
1 dakikada hazırlayabileceğim ve bu yemeğin yanına yakışacak bir atıştırmalık nedir? Lütfen nedeniyle birlikte açıklayın. |
Örnekleme parametrelerini ayarlama
Her istekte modele yalnızca çoklu modal istemi değil, bir dizi örnekleme parametresi de gönderirsiniz. Model, farklı parametre değerleri için farklı sonuçlar oluşturabilir. Görev için en iyi değerleri elde etmek üzere farklı parametrelerle denemeler yapın. En sık ayarlanan parametreler şunlardır:
- Sıcaklık
- üst-P
- ilk-K
Sıcaklık
Sıcaklık, en yüksek P ve en yüksek K uygulandığında gerçekleşen yanıt oluşturma sırasında örnekleme için kullanılır.
Sıcaklık, jeton seçimindeki rastgelelik derecesini kontrol eder. Düşük sıcaklıklar, daha kesin ve daha az açık uçlu veya yaratıcı yanıt gerektiren istemler için tercih edilir. Yüksek sıcaklıklar ise daha çeşitli veya yaratıcı sonuçlar sunabilir. Sıcaklık 0 olduğunda her zaman en yüksek olasılık yanıtı seçilir.
Çoğu kullanım alanı için 0, 4 sıcaklıkla başlamayı deneyin. Daha yaratıcı sonuçlara ihtiyacınız varsa sıcaklığı artırmayı deneyin. Net halüsinasyonlar görüyorsanız sıcaklığı düşürmeyi deneyin.
İlk K
Top-K, modelin çıkış için jetonları nasıl seçtiğini değiştirir. 1'e ayarlanmış bir K değeri, seçilen bir sonraki jetonun modelin kelime haznesindeki tüm jetonlar arasında en olası jeton olduğu anlamına gelir (açgözlü kod çözme olarak da bilinir). 3'e ayarlanmış bir K değeri ise bir sonraki jetonun, sıcaklık kullanılarak en olası üç jeton arasından seçildiği anlamına gelir.
Her jeton seçim adımında, en yüksek olasılığa sahip ilk K jeton örneklenir. Ardından jetonlar, en yüksek P değerine göre daha da filtrelenir ve son jeton, sıcaklık örnekleme kullanılarak seçilir.
Daha az rastgele yanıt için daha düşük, daha fazla rastgele yanıt için daha yüksek bir değer belirtin. En iyi K değerinin varsayılan değeri 32'dir.
Top-P
Top-P, modelin çıkış için jetonları nasıl seçtiğini değiştirir. Jetonlar, olasılıklarının toplamı en yüksek P değerine eşit olana kadar en yüksek (en yüksek K değerine bakın) olasılıktan en düşük olasılığa kadar seçilir. Örneğin, A, B ve C jetonlarının olasılıkları 0,6, 0,3 ve 0,1 ise ve en yüksek P değeri 0,9 ise model, sıcaklığı kullanarak sonraki jeton olarak A veya B'yi seçer ve C'yi aday olarak hariç tutar.
Daha az rastgele yanıt için daha düşük, daha fazla rastgele yanıt için daha yüksek bir değer belirtin. En yüksek P değerinin varsayılan değeri 1,0'dur.
Sonraki adımlar
- Google AI Studio'yu kullanarak kendi çoklu formatlı istemlerinizi yazmayı deneyin.
- İstem tasarımı hakkında daha fazla bilgi için İstem stratejileri sayfasına bakın.