Dosyalar API'si

Gemini; metin, resim ve ses gibi çeşitli giriş verilerini aynı anda işleyebilir.

Bu kılavuzda, Files API'yi kullanarak medya dosyalarıyla nasıl çalışacağınız gösterilmektedir. Ses dosyaları, resimler, videolar, dokümanlar ve desteklenen diğer dosya türleri için temel işlemler aynıdır.

Dosya istemiyle ilgili rehberlik için Dosya istemi kılavuzu bölümüne göz atın.

Dosya yükleyin

Medya dosyası yüklemek için Files API'yi kullanabilirsiniz. Toplam istek boyutu (dosyalar, yazılı istem, sistem talimatları vb. dahil) 100 MB'tan büyükse her zaman Files API'yi kullanın. Bu sınır, PDF dosyaları için 50 MB'tır.

Aşağıdaki kod bir dosya yükler ve ardından bu dosyayı interactions.create çağrısında kullanır.

Python

from google import genai

client = genai.Client()

myfile = client.files.upload(file="path/to/sample.mp3")

interaction = client.interactions.create(
    model="gemini-3.8-flash",
    input=[
        {"type": "text", "text": "Describe this audio clip"},
        {"type": "audio", "uri": myfile.uri, "mime_type": myfile.mime_type}
    ]
)

print(interaction.output_text)

JavaScript

import { GoogleGenAI } from "@google/genai";

const client = new GoogleGenAI({});

async function main() {
  const myfile = await client.files.upload({
    file: "path/to/sample.mp3",
    config: { mime_type: "audio/mpeg" },
  });

  const interaction = await client.interactions.create({
    model: "gemini-3.8-flash",
    input: [
      { type: "text", text: "Describe this audio clip" },
      { type: "audio", uri: myfile.uri, mime_type: myfile.mimeType }
    ]
  });
  console.log(interaction.output_text);
}

await main();

Java

import com.google.genai.Client;
import com.google.genai.gaos.models.interactions.AudioContent;
import com.google.genai.gaos.models.interactions.AudioContentMimeType;
import com.google.genai.gaos.models.interactions.Content;
import com.google.genai.gaos.models.interactions.CreateModelInteraction;
import com.google.genai.gaos.models.interactions.Interaction;
import com.google.genai.gaos.models.interactions.InteractionsInput;
import com.google.genai.gaos.models.interactions.Model;
import com.google.genai.gaos.models.interactions.TextContent;
import com.google.genai.gaos.models.operations.CreateInteractionRequestBody;
import com.google.genai.types.File;
import com.google.genai.types.UploadFileConfig;
import java.util.Arrays;
import java.util.List;

Client client = new Client();

File myFile =
    client.files.upload(
        new java.io.File("path/to/sample.mp3"),
        UploadFileConfig.builder().mimeType("audio/mp3").build());

Content textContent = TextContent.builder().text("Describe this audio clip").build();
Content audioContent =
    AudioContent.builder()
        .uri(myFile.uri().orElse(""))
        .mimeType(AudioContentMimeType.of(myFile.mimeType().orElse("audio/mp3")))
        .build();

List<Content> contents = Arrays.asList(textContent, audioContent);

CreateModelInteraction params =
    CreateModelInteraction.builder()
        .model(Model.of("gemini-3.8-flash"))
        .input(InteractionsInput.ofContent(contents))
        .build();

Interaction interaction =
    client.interactions.create(CreateInteractionRequestBody.of(params)).interaction().get();

System.out.println(interaction.outputText().orElse(""));

Go

package main

import (
    "context"
    "fmt"
    "log"

    "google.golang.org/genai"
    "google.golang.org/genai/interactions/models/interactions"
    "google.golang.org/genai/interactions/models/operations"
)

func main() {
    ctx := context.Background()
    client, err := genai.NewClient(ctx, nil)
    if err != nil {
        log.Fatal(err)
    }

    myFile, err := client.Files.UploadFromPath(ctx, "path/to/sample.mp3", &genai.UploadFileConfig{
        MIMEType: "audio/mp3",
    })
    if err != nil {
        log.Fatal(err)
    }

    res, err := client.Interactions.Create(ctx, operations.CreateInteractionRequest{
        Body: operations.NewCreateInteractionRequestBody(interactions.CreateModelInteraction{
            Model: interactions.Model("gemini-3.8-flash"),
            Input: interactions.NewInteractionsInput([]interactions.Content{
                interactions.NewContent(interactions.TextContent{
                    Text: "Describe this audio clip",
                }),
                interactions.NewContent(interactions.AudioContent{
                    URI:      genai.Ptr(myFile.URI),
                    MimeType: interactions.AudioContentMimeType(myFile.MIMEType).ToPointer(),
                }),
            }),
        }),
    })
    if err != nil {
        log.Fatal(err)
    }
    if res.Interaction.OutputText != nil {
        fmt.Println(*res.Interaction.OutputText)
    }
}

REST

AUDIO_PATH="path/to/sample.mp3"
MIME_TYPE=$(file -b --mime-type "${AUDIO_PATH}")
NUM_BYTES=$(wc -c < "${AUDIO_PATH}")
DISPLAY_NAME=AUDIO

tmp_header_file=upload-header.tmp

# Initial resumable request defining metadata.
# The upload url is in the response headers dump them to a file.
curl "${BASE_URL}/upload/v1beta/files" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -D "${tmp_header_file}" \
  -H "X-Goog-Upload-Protocol: resumable" \
  -H "X-Goog-Upload-Command: start" \
  -H "X-Goog-Upload-Header-Content-Length: ${NUM_BYTES}" \
  -H "X-Goog-Upload-Header-Content-Type: ${MIME_TYPE}" \
  -H "Content-Type: application/json" \
  -d "{'file': {'display_name': '${DISPLAY_NAME}'}}" 2> /dev/null

upload_url=$(grep -i "x-goog-upload-url: " "${tmp_header_file}" | cut -d" " -f2 | tr -d "\r")
rm "${tmp_header_file}"

# Upload the actual bytes.
curl "${upload_url}" \
  -H "Content-Length: ${NUM_BYTES}" \
  -H "X-Goog-Upload-Offset: 0" \
  -H "X-Goog-Upload-Command: upload, finalize" \
  --data-binary "@${AUDIO_PATH}" 2> /dev/null > file_info.json

file_uri=$(jq ".file.uri" file_info.json)
echo file_uri=$file_uri

# Now create an interaction using the Interactions API
curl -X POST "https://generativelanguage.googleapis.com/v1beta/interactions" \
    -H "x-goog-api-key: $GEMINI_API_KEY" \
    -H 'Content-Type: application/json' \
    -d '{
      "model": "gemini-3.8-flash",
      "input": [
        {"type": "text", "text": "Describe this audio clip"},
        {"type": "audio", "uri": '$file_uri', "mime_type": "'${MIME_TYPE}'"}
      ]
    }' 2> /dev/null > response.json

cat response.json
echo

jq ".outputs[] | select(.type == \"text\") | .text" response.json

Bir dosyanın meta verilerini alma

API'nin, yüklenen dosyayı başarıyla depoladığını doğrulayabilir ve files.get yöntemini çağırarak dosyanın meta verilerini alabilirsiniz.

Python

from google import genai

client = genai.Client()

myfile = client.files.upload(file='path/to/sample.mp3')
file_name = myfile.name
myfile = client.files.get(name=file_name)
print(myfile)

JavaScript

import {
  GoogleGenAI,
} from "@google/genai";

const client = new GoogleGenAI({});

async function main() {
  const myfile = await client.files.upload({
    file: "path/to/sample.mp3",
    config: { mime_type: "audio/mpeg" },
  });

  const fileName = myfile.name;
  const fetchedFile = await client.files.get({ name: fileName });
  console.log(fetchedFile);
}

await main();

Java

import com.google.genai.Client;
import com.google.genai.types.File;
import com.google.genai.types.UploadFileConfig;

Client client = new Client();

File myFile =
    client.files.upload(
        new java.io.File("path/to/sample.mp3"),
        UploadFileConfig.builder().mimeType("audio/mp3").build());

String fileName = myFile.name().orElse("");
File fileMetadata = client.files.get(fileName, null);
System.out.println(fileMetadata);

Go

package main

import (
    "context"
    "fmt"
    "log"

    "google.golang.org/genai"
)

func main() {
    ctx := context.Background()
    client, err := genai.NewClient(ctx, nil)
    if err != nil {
        log.Fatal(err)
    }

    myFile, err := client.Files.UploadFromPath(ctx, "path/to/sample.mp3", &genai.UploadFileConfig{
        MIMEType: "audio/mp3",
    })
    if err != nil {
        log.Fatal(err)
    }

    fileMetadata, err := client.Files.Get(ctx, myFile.Name, nil)
    if err != nil {
        log.Fatal(err)
    }
    fmt.Println(fileMetadata)
}

REST

# file_info.json was created in the upload example
name=$(jq -r ".file.name" file_info.json)
# Get the file of interest to check state
curl https://generativelanguage.googleapis.com/v1beta/$name \
-H "x-goog-api-key: $GEMINI_API_KEY" > file_info.json
# Print some information about the file you got
name=$(jq -r ".name" file_info.json)
echo name=$name
file_uri=$(jq -r ".uri" file_info.json)
echo file_uri=$file_uri

Yüklenen dosyaları listeleme

Aşağıdaki kod, yüklenen tüm dosyaların listesini alır:

Python

from google import genai

client = genai.Client()

print('My files:')
for f in client.files.list():
    print(' ', f.name)

JavaScript

import {
  GoogleGenAI,
} from "@google/genai";

const client = new GoogleGenAI({});

async function main() {
  const listResponse = await client.files.list({ config: { pageSize: 10 } });
  for await (const file of listResponse) {
    console.log(file.name);
  }
}

await main();

Java

import com.google.genai.Client;
import com.google.genai.types.File;

Client client = new Client();

System.out.println("My files:");
for (File f : client.files.list(null)) {
  System.out.println("  " + f.name().orElse(""));
}

Go

package main

import (
    "context"
    "fmt"
    "log"

    "google.golang.org/genai"
)

func main() {
    ctx := context.Background()
    client, err := genai.NewClient(ctx, nil)
    if err != nil {
        log.Fatal(err)
    }

    fmt.Println("My files:")
    for f, err := range client.Files.All(ctx) {
        if err != nil {
            log.Fatal(err)
        }
        fmt.Println(" ", f.Name)
    }
}

REST

echo "My files: "

curl "https://generativelanguage.googleapis.com/v1beta/files" \
  -H "x-goog-api-key: $GEMINI_API_KEY"

Yüklenen dosyaları silme

Dosyalar 48 saat sonra otomatik olarak silinir. Yüklenen bir dosyayı manuel olarak da silebilirsiniz:

Python

from google import genai

client = genai.Client()

myfile = client.files.upload(file='path/to/sample.mp3')
client.files.delete(name=myfile.name)

JavaScript

import {
  GoogleGenAI,
} from "@google/genai";

const client = new GoogleGenAI({});

async function main() {
  const myfile = await client.files.upload({
    file: "path/to/sample.mp3",
    config: { mime_type: "audio/mpeg" },
  });

  const fileName = myfile.name;
  await client.files.delete({ name: fileName });
}

await main();

Java

import com.google.genai.Client;
import com.google.genai.types.File;
import com.google.genai.types.UploadFileConfig;

Client client = new Client();

File myFile =
    client.files.upload(
        new java.io.File("path/to/sample.mp3"),
        UploadFileConfig.builder().mimeType("audio/mp3").build());

client.files.delete(myFile.name().orElse(""), null);

Go

package main

import (
    "context"
    "log"

    "google.golang.org/genai"
)

func main() {
    ctx := context.Background()
    client, err := genai.NewClient(ctx, nil)
    if err != nil {
        log.Fatal(err)
    }

    myFile, err := client.Files.UploadFromPath(ctx, "path/to/sample.mp3", &genai.UploadFileConfig{
        MIMEType: "audio/mp3",
    })
    if err != nil {
        log.Fatal(err)
    }

    if _, err := client.Files.Delete(ctx, myFile.Name, nil); err != nil {
        log.Fatal(err)
    }
}

REST

curl --request "DELETE" https://generativelanguage.googleapis.com/v1beta/$name \
  -H "x-goog-api-key: $GEMINI_API_KEY"

Kullanım bilgileri

Medya dosyalarını yüklemek ve bunlarla etkileşim kurmak için Files API'yi kullanabilirsiniz. Files API, proje başına 20 GB'a kadar dosya depolamanıza olanak tanır. Dosya başına maksimum boyut 2 GB'tır. Dosyalar 48 saat boyunca saklanır.

Bu süre zarfında, dosyalarla ilgili meta verileri almak için API'yi kullanabilirsiniz. Ancak kullanıcılar tarafından yüklenen dosyaları indiremezsiniz. Modeller tarafından üretilen dosyaları (ör. videolar) files.download yöntemini kullanarak indirebilirsiniz. Files API, Gemini API'nin kullanılabildiği tüm bölgelerde ücretsiz olarak kullanılabilir.

Dosya istemi stratejileri

Bu bölümde, Gemini API istemleriyle medya dosyalarının kullanımına ilişkin rehberlik ve en iyi uygulamalar sunulmaktadır.

İstemlerinizde çeşitli veri türlerini kullanabilmek, Gemini API ile gerçekleştirebileceğiniz görevler açısından size daha fazla esneklik sağlar. Örneğin, modele lezzetli bir yemeğin fotoğrafını gönderip yemekle ilgili kısa bir blog yazısı yazmasını isteyebilirsiniz.

İstem Yanıt

Bu resme dayalı kısa ve ilgi çekici bir blog yayını yaz. Fotoğraftaki yemeğin açıklamasını içermeli ve yemek hazırlama yolculuğumdan bahsetmeli.


Çerezler

Öğün hazırlama, zamandan ve paradan tasarruf etmenin harika bir yoludur. Ayrıca daha sağlıklı beslenmenize de yardımcı olabilir. Bu yemek, önceden hazırlanabilen sağlıklı ve lezzetli bir yemeğe harika bir örnektir.

Bu yemekte kahverengi pirinç, fırınlanmış sebzeler ve teriyaki soslu tavuk bulunur. Kahverengi pirinç, size uzun süreli enerji verecek sağlıklı ve karmaşık bir karbonhidrattır. Közlenmiş sebzeler, günlük vitamin ve mineral ihtiyacınızı karşılamanın harika bir yoludur. Teriyaki soslu tavuk ise lezzetli ve protein açısından zengin bir seçenektir.

Bu yemeğin hazırlanması da kolaydır. Kahverengi pirinci pişirin, sebzeleri kavurun ve teriyaki soslu tavuğu pişirin. Her şey piştikten sonra yemekleri kaplara bölüp buzdolabında saklayın. Yoğun sabahlarınızda bir kap alıp hemen çıkabilirsiniz.

Önceden hazırlanabilecek sağlıklı ve lezzetli bir yemek arıyorsanız bu yemek harika bir seçenektir. Besin değeri yüksek ve lezzetli olan bu yemek, sizi tok tutacak ve tatmin edecek.

Sağlıklı ve lezzetli yemekler hazırlamanız dileğiyle.

Medya dosyalarını kullanan istemlerden istediğiniz çıkışı almakta sorun yaşıyorsanız istediğiniz sonuçları elde etmenize yardımcı olabilecek bazı stratejiler vardır. Aşağıdaki bölümlerde, çok formatlı 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 çok formatlı istemlerinizi iyileştirebilirsiniz:

  • İstem tasarımının temelleri

    • Talimatlarınızda net olun: Yanlış yorumlamaya mümkün olduğunca az yer bırakan, net ve kısa talimatlar oluşturun.
    • İsteminize birkaç örnek ekleyin: Elde etmek istediğiniz sonucu göstermek için gerçekçi few-shot örnekleri kullanın.
    • Adım adım ilerleyin: Karmaşık görevleri yönetilebilir alt hedeflere bölerek modele süreç boyunca rehberlik edin.
    • Çıkış biçimini belirtin: İsteminizde çıkışın Markdown, JSON, HTML gibi istediğiniz biçimde olmasını talep edin.
    • Tek resimli istemlerde resminizi ilk sıraya koyun: Gemini, resim ve yazılı istem girişlerini herhangi bir sırayla işleyebilir ancak tek bir resim içeren istemlerde, bu resim (veya video) yazılı istemden önce yerleştirilirse daha iyi performans gösterebilir. Ancak anlamlı olması için resimlerin metinlerle iç içe geçmesi gereken istemlerde en doğal sıralamayı kullanın.
  • Çok formatlı istem yazma sorunlarını giderme

    • Model, görüntünün alakalı kısmından bilgi almıyorsa: İstemde, görüntünün hangi kısımlarından bilgi alınmasını istediğinize dair ipuçları verin.
    • Model çıktısı çok genel ise (görüntü/video girişine yeterince uygun değilse): İstemin başında, görev talimatını vermeden önce modelden görüntüleri veya videoyu açıklamasını ya da görüntüdeki öğelere atıfta bulunmasını isteyin.
    • Hangi bölümün başarısız olduğunu anlamak için: Modelden görüntüyü açıklamasını veya gerekçesini açıklamasını isteyerek modelin ilk anlayışını ölçün.
    • İsteminiz halüsinasyonlu içerikle sonuçlanıyorsa: Sıcaklık ayarını düşürmeyi veya modelden daha kısa açıklamalar istemeyi deneyin. Böylece modelin ek ayrıntılar uydurma olasılığı azalır.
    • Örnekleme parametrelerini ayarlama: Modelin yaratıcılığını ayarlamak için farklı sıcaklık ayarları ve top-k seçimleriyle denemeler yapın.

Talimatlarınızda ayrıntılı bilgi verin

İstemler net ve ayrıntılı olduğunda en iyi sonucu verir. Aklınızda belirli bir çıktı varsa istediğiniz çıktıyı elde etmek için bu şartı isteme eklemeniz daha iyi olur.

Havaalanı panosunun bu görüntüsü için modelden yalnızca "bu görüntüyü açıklamasını" istemek genel bir açıklama oluşturabilir. Modelin resimdeki zamanı ve şehri ayrıştırması gerekiyorsa bu isteği doğrudan isteminize ekleyebilirsiniz.

İstem Model yanıtı

Bu resmi tanımla.

Resimde havaalanı varış ve kalkış panosu gösteriliyor.

Güncellenen istem İyileştirilmiş yanıt
Seyahat zaman çizelgesi

Parse the time and city from the airport board shown in this image into a list.

  • 10:50 Moskova
  • 11:05 Edinburgh
  • 11:05 Londra
  • 11:10 Bükreş
  • 11:30 Kiev
  • 11:35 Dublin
  • 11:45 East Midlands
  • 12:15 Sofya
  • 12:30 Londra
  • 12:30 Newcastle
  • 12:40 St Petersburg
  • 12:40 Londra
  • 12:45 Manchester
  • 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ğe uygulamasına yardımcı olabilir. Buna "few-shot" öğrenme de denir.

    Aşağıdaki örnekte, ilk çıkış cümle biçiminde yazılmıştır ve ülke (Brezilya) bilgisini de içerir. Çıktıyı farklı bir biçimde veya stilde istediğinizi ve ülke değil, yalnızca şehir istediğinizi varsayalım. İsteminize few-shot örnekleri ekleyerek modelin istediğiniz şekilde yanıt vermesini sağlayabilirsiniz.

    İstem Model yanıtı
    Seyahat zaman çizelgesi

    Önemli yerle birlikte şehri belirleyin.

    Bu önemli yer, Brezilya'nın Rio de Janeiro kentindeki Kurtarıcı İsa heykelidir.

    Güncellenen istem İyileştirilmiş yanıt

    Önemli yerle birlikte şehri belirleyin.

    kolezyum

    Şehir: Roma, önemli yer: Kolezyum.

    Yasak Şehir

    city: Beijing, landmark: Forbidden City

    forbidden-city

    şehir: Rio de Janeiro, önemli yer: Kurtarıcı İsa heykeli

    Adım adım açıklama

    Hem görsel anlayış hem de akıl yürütme gerektiren karmaşık görevlerde, görevi daha küçük ve daha basit adımlara bölmek faydalı olabilir. Alternatif olarak, isteminizde modelden doğrudan "adım adım düşünmesini" istemek de etkili olabilir.

    İstem Model yanıtı

    Tuvalet kağıdım ne zaman biter?

    Kısa süre sonra yalnızca 3 rulo kalır.

    Güncellenen istem İyileştirilmiş yanıt
    1. Öncelikle bu resimde kaç tane tuvalet kağıdı rulosu olduğunu say.
    2. Ardından, bir kişinin günde ortalama ne kadar tuvalet kağıdı kullandığını belirleyin.
    3. Bu tuvalet kağıdı rulolarının ne kadar süre yeteceğini hesaplayın.
    1. Bu resimde 3 rulo tuvalet kağıdı var.
    2. Bir kişi günde ortalama 20 yaprak tuvalet kağıdı kullanır.
    3. Her ruloda 200 yaprak varsa her rulo yaklaşık 10 gün dayanır. Bu nedenle, 3 rulo yaklaşık bir ay boyunca yeterli olacaktır.

    Matematik problemleri veya diğer sözel problemler, modelden adım adım düşünmesini istemek için idealdir.

    İstem Yanıt

    Dizideki 4. terim nedir?

    -135

    Modelden gelen yanıt yanlış. Bu durumu iyileştirmenin bir yolu, modelden istemi yanıtlamadan önce problemi ayrıştırmasını istemektir.

    İstem Yanıt

    Önce resimdeki formülü ayrıştırın.

    Ardından, formüle göre "Dizideki 4. terim nedir?" sorusunu yanıtlayın.

    Sonucu genişletmek için tıklayın

    $$ b(n) = b(n-1) * (-3) $$

    $$ b(1) = 15 $$

    1. Formülde n = 4 değerini yerine koyun:

      $$ b(4) = b(4-1) * (-3) $$

      $$ b(4) = b(3) * (-3) $$

    2. b(3)'ün değerini bilmiyoruz, bu yüzden formülde n yerine 3 yazalım:

      $$ b(3) = b(3-1) * (-3) $$

      $$ b(3) = b(2) * (-3) $$

    3. b(2)'nin değerini bilmiyoruz. Bu nedenle formülde n yerine 2 yazalım:

      $$ b(2) = b(2-1) * (-3) $$

      $$ b(2) = b(1) * (-3) $$

    4. b(1) değerinin 15 olduğunu biliyoruz. Bu değeri formülde yerine koyalım:

      $$ b(2) = 15 * (-3) $$

      $$ b(2) = -45 $$

    5. b(2) değerini bildiğimize göre b(3) formülünde yerine koyalım:

      $$ b(3) = b(2) * (-3) $$

      $$ b(3) = -45 * (-3) $$

      $$ b(3) = 135 $$

    6. b(3) değerini bildiğimize göre bunu b(4) formülünde yerine koyalım:

      $$ b(4) = b(3) * (-3) $$

      $$ b(4) = 135 * (-3) $$

      $$ b(4) = -405 $$

    Bu nedenle, dizideki 4. terim -405'tir.

    Modelin bu yanıtı doğru. Yanıtı daha da akıcı hale getirmek için modelden adım adım düşünmesini isteyebilirsiniz.

    Güncellenen istem İyileştirilmiş yanıt

    Dizideki 4. terim 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 belirtme

    Sık karşılaşılan sorunlardan biri, model çıktısının belirli bir biçimde (ör.Markdown, JSON, HTML) olması gerektiğidir. Bu durum, özellikle model çıktısının bir alt görev tarafından alınması gerektiğinde geçerlidir. İstemde modele talimat vererek bu biçimde çıkış üretmesini deneyebilirsiniz. Aşağıda iki örnek verilmiştir:

    İstem Model yanıtı

    Bu resimdeki tabloyu Markdown biçiminde ayrıştır

    ```none | Subject | Status | Time | Start date | Due on | | ------- | ------ | ---- | ---------- | ------ | | Math | Done | 1.5 hrs | 11/29/2023 | 12/1/2023 | | Geography | Done | 30 min | 12/2/2023 | 12/4/2023 | | Physics | In progress | 2 hrs | 12/3/2023 | 12/5/2023 | | Biology | Not started | 6 hrs | 11/2/2016 | 12/6/2023 | ```
    İstem Model yanıtı

    Aşağıdaki tüm özelliklerin listesini sağlayın:

    malzemeler, mutfak türü, vejetaryen olup olmadığı, JSON biçiminde

    ```json { "ingredients": [ "rice", "shrimp", "clams", "mussels", "peas", "tomatoes", "onions", "garlic", "olive oil", "paprika", "salt", "pepper" ], "type of cuisine": "Spanish", "vegetarian": false } ```

    Tek resim içeren istemlerde önce resminizi ekleyin.

    Gemini, bir istemdeki resim ve metni herhangi bir sırayla yorumlayabilir ancak yazılı istemden önce tek bir resim yerleştirmek daha iyi sonuçlar verebilir. Aşağıdaki örneklerde, her istemde metinden önce resmin geldiğini göreceksiniz.

    Çok formatlı istem yazma sorunlarını giderme

    Faydalı bir yanıt alamıyorsanız isteminizle ilgili sorunları gidermeniz gerekebilir. Deneyebileceğiniz birkaç strateji:

    Model, görüntünün ilgili bölümünden bilgi almıyorsa

    Daha spesifik bir yanıt almak için istemin, yanıtını oluştururken görüntünün hangi yönlerinden bilgi almasını istediğinizi belirtebilirsiniz.

    İstem Model yanıtı

    Bu bebek bezleri bir bebeğe kaç gün yeter?

    Bezler 198 gün boyunca yeterli olacaktır.

    Güncellenen istem İyileştirilmiş yanıt

    Bu bezler ne kadar süre yeter?

    Ç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 kullandığı bez sayısına bölün.

    Kutuda 198 bebek bezi var. Kutuda, bezlerin 10-17 kg ağırlığındaki çocuklar için olduğu belirtiliyor.

    Bu ağırlık aralığındaki ortalama bir çocuk muhtemelen 1 ila 2 yaşındadır.

    2 yaşındaki bir çocuk genellikle günde 6 bez kullanır. Bu nedenle, bezler yaklaşık 33 gün (198/6) yeterli olur.

    Model çıktısı çok genel ve resim girişine yeterince uygun değilse

    Modelin yanıtını resimlere göre uyarlamasına yardımcı olmak için akıl 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çılığına örnektir.

    Güncellenen istem İyileştirilmiş yanıt

    Öncelikle her resimde ne olduğunu ayrıntılı olarak açıklayın. Bu resimlerin ortak noktası nedir?

    İlk resimde bavul hazırlayan bir kişi gösteriliyor. İkinci resimde bir alışveriş merkezindeki boş bir koridor gösteriliyor. Üçü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. Eşik mekanlar, iki farklı yer veya durum arasında kalan yerler ya da durumlardır. Bu tür sorunlar genellikle belirsizlik veya muğlaklık hissiyle karakterize edilir.

    İlk resimde, evde ve seyahatte olan kişi gösteriliyor. İkinci resimde iki mağaza arasındaki koridor gösteriliyor. Üçüncü resimde, banyoyu temsil edebilecek tuvalet kağıdı gösteriliyor. Banyo, özel ve kamusal alanlar arasında geçiş sağlayan bir mekandır. Dış dünyaya girmeye veya dış dünyadan ayrılmaya hazırlandığımız bir yerdir.

    Dördüncü resimde deniz, sakin ve fırtınalı arasında bir durumda gösteriliyor.

    Geçiş alanları hem heyecan verici hem de rahatsız edici olabilir. Yeni bir başlangıç veya sonun geldiği yer olabilir. Düşünme veya harekete geçme yeri olabilirler.

    Modelden açıkça görüntüdeki öğelere başvurmasını istemeyi de deneyebilirsiniz.

    Güncellenen istem İyileştirilmiş yanıt

    Bu resimlerin ortak noktası nedir? Yanıtınızda resimlerdeki öğelere atıfta bulunun.

    Tüm resimler seyahatle ilgilidir. İlk resimde bavul hazırlayan bir kişi, ikinci resimde bir alışveriş merkezindeki boş bir koridor, üçüncü resimde bir rulo tuvalet kağıdı ve dördüncü resimde karanlık ve fırtınalı bir deniz gösteriliyor.

    Bu resimlerin tümü seyahatle ilgilidir çünkü hepsi insanların seyahat ederken ihtiyaç duyduğu veya kullandığı şeylerdir. İlk resimde, seyahate çıkacak bir kişinin bavulunu hazırladığı görülüyor. İkinci resimde, insanların genellikle seyahatleri için alışveriş yapmak üzere gittiği bir alışveriş merkezinin boş koridoru gösteriliyor. Üçüncü resimde, insanların seyahat ederken sıkça kullandığı tuvalet kağıdı rulosu gösteriliyor. Dördüncü resimde, insanların seyahat ederken sıkça karşılaştığı karanlık ve fırtınalı bir deniz gösteriliyor.

    Aynı ipuçları, resimlerden elde edilen reklam öğesi çıkışları için de geçerlidir. Tavşanla ilgili aşağıdaki örnekte, modelden resimdeki unsurları dahil etmesini açıkça istemek çıkışı iyileştirebilir.

    İstem Model yanıtı

    Bu görsel hakkında bir şiir yazabilir misin?

    Küçük tavşan, yumuşak ve kahverengi,
    Tarlada zıplıyor, yukarı ve aşağı.
    Kulakların uzun, kuyruğun küçük,
    En tatlı canlı sensin, minik tavşan.

    Yeşil ve tatlı otları kemirirsin,
    Beni görünce zıplayarak kaçarsın.
    Ama her zaman arkadaşın olacağım,
    Küçük tavşan, sonuna kadar.

    Güncellenen istem İyileştirilmiş yanıt

    Bu görsel hakkında açıklayıcı ve dramatik bir şiir yazıp konumu da ekleyebilir misin?

    Küçük tavşan yeşillikte,
    Kulakları uzun, keskin.
    Ne görüyorsun orada,
    Uzaklarda, baktığın yerde?

    Okyanusun mavisi mi,
    Güneşin ışığında parıldayan?
    Yoksa dalgaların gürültüsü mü,
    Sizi büyüleyen ritim?

    Küçük tavşan, söyle bana,
    Nedir seni böyle büyüleyen?
    Tuzlu rüzgar mı,
    Yoksa martıların çığlıkları mı hoşuna giden?

    Belki de her şeyin büyüklüğüdür,
    Hem büyük hem küçük bir dünya.
    Hayallerin dolaşabileceği,
    Maceraların yeşerebileceği bir yer.

    Küçük tavşan, merak ediyorum ne rüya görüyorsun,
    Çimlerin üzerinde otururken, çok huzurlu görünüyorsun.
    Derinlikleri keşfetmek mi istersin,
    Yoksa karada kalıp zıplamak mı?

    Ne olursa olsun, küçük tavşan,
    Merak kıvılcımını her zaman canlı tut.
    Hayallerinizde ve isteklerinizde,
    Yaratmanızı bekleyen bir dünya var.

    İstemin hangi bölümünün başarısız olduğunu giderme

    Bir istemin başarısız olmasının nedeni, modelin başlangıçta görüntüyü anlamaması mı yoksa görüntüyü anlamasına rağmen doğru akıl yürütme adımlarını uygulamaması mı, bunu anlamak zor olabilir. Bu nedenler arasındaki anlam belirsizliğini gidermek için modelden resimdeki öğeleri açıklamasını isteyin.

    Aşağıdaki örnekte, model çayla birlikte tüketildiğinde şaşırtıcı görünen bir atıştırmalık (ör. patlamış mısır) önerirse öncelikle modelin resimde çay olduğunu doğru şekilde tanıyıp tanımadığını belirlemek için sorun giderebilirsiniz.

    İstem Sorun giderme istemi

    Bununla iyi gidecek ve 1 dakikada hazırlayabileceğim bir atıştırmalık önerir misin?

    Bu resimde ne olduğunu açıklayın.

    Diğer bir strateji de modelden akıl yürütme sürecini açıklamasını istemektir. Bu sayede, akıl yürütmenin hangi kısmında hata olduğunu (varsa) daha kolay tespit edebilirsiniz.

    İstem Sorun giderme istemi

    Bununla iyi gidecek ve 1 dakikada hazırlayabileceğim bir atıştırmalık önerir misin?

    Bununla iyi gidecek ve 1 dakikada hazırlayabileceğim bir atıştırmalık önerir misin? Lütfen nedeniyle birlikte açıklayın.

    Sırada ne var?

    • Google AI Studio'yu kullanarak kendi çok formatlı istemlerinizi yazmayı deneyin.
    • Medya dosyalarını yüklemek ve istemlerinize dahil etmek için Gemini Files API'yi kullanma hakkında bilgi edinmek istiyorsanız Vision, Ses ve Belge işleme kılavuzlarını inceleyin.
    • Örnekleme parametrelerini ayarlama gibi istem tasarımıyla ilgili daha fazla bilgi için İstem stratejileri sayfasını inceleyin.