İçerik Oluşturma (Generate Content)

Gemini Models API tarafından döndürülen bir modeli kullanarak Gemini istek ve yanıt formatlarını kullanın. ProtoJSON lowerCamelCase ve buna karşılık gelen proto snake_case alan adları kabul edilir. Desteklenen isteğe bağlı alanlar ve değerler, seçilen modele bağlıdır.

Yol Parametreleri (Path Parameters)Copy Anchor Link

Sorgu Parametreleri (Query Parameters)Copy Anchor Link

Kimlik Doğrulama (Authentication)Copy Anchor Link

Gemini uç noktaları birden fazla kimlik doğrulama yöntemini destekler:

• ?key=YOUR_API_KEY sorgu parametresi
• x-goog-api-key: YOUR_API_KEY başlığı
• Authorization: Bearer YOUR_API_KEY başlığı

İstek Gövdesi (Request Body)Copy Anchor Link

Yukarıda gösterilen her lowerCamelCase alan, resmi proto snake_case yazımıyla da kullanılabilir; örneğin system_instruction, generation_config, safety_settings, tool_config, cached_content, file_data.file_uri ve inline_data.mime_type.

Desteklenen Yöntemler (Supported Methods)Copy Anchor Link

Gemini uyumlu API; model listeleme/getirme, generateContent, streamGenerateContent, countTokens, embedContent ve batchEmbedContents yöntemlerini içerir. Gemini Interactions ve Live kullanılamaz.

Yanıt (Response)Copy Anchor Link

curl -X POST "https://api.tokenlab.sh/v1beta/models/gemini-2.5-pro:generateContent?key=sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "parts": [{"text": "Hello, Gemini!"}]
      }
    ],
    "generationConfig": {
      "temperature": 0.7,
      "maxOutputTokens": 1024
    }
  }'

Görsel Giriş Örneği (Vision Input Example)Copy Anchor Link

Gemini çok modlu (multimodal) istekleri için medyayı contents[].parts[] içine satır içi baytlar veya URL tabanlı dosya referansları kullanarak yerleştirin.

Genel Gemini sözleşmesindeki desteklenen medya kategorileri:

• image
• audio
• video

Satır içi medya için inlineData veya inline_data kullanın ve Base64 kodlu dosya baytlarını iletin.

URL tabanlı medya için fileData veya file_data kullanın ve herkese açık bir https URL'si iletin.

Video Giriş ÖrneğiCopy Anchor Link

{
  "contents": [
    {
      "role": "user",
      "parts": [
        { "text": "Please describe this video." },
        {
          "fileData": {
            "mimeType": "video/mp4",
            "fileUri": "https://example.com/demo.mp4"
          }
        }
      ]
    }
  ]
}

Ses Giriş ÖrneğiCopy Anchor Link

{
  "contents": [
    {
      "role": "user",
      "parts": [
        { "text": "Please describe this audio." },
        {
          "fileData": {
            "mimeType": "audio/mpeg",
            "fileUri": "https://example.com/demo.mp3"
          }
        }
      ]
    }
  ]
}

Görsel Giriş ÖrneğiCopy Anchor Link

Satır içi görsel baytlarını kullanın:

{
  "contents": [
    {
      "role": "user",
      "parts": [
        { "text": "Please describe this image." },
        {
          "inlineData": {
            "mimeType": "image/jpeg",
            "data": "/9j/4AAQSkZJRgABAQ..."
          }
        }
      ]
    }
  ]
}

Bir görsel URL'si kullanın:

{
  "contents": [
    {
      "role": "user",
      "parts": [
        { "text": "Please describe this image." },
        {
          "fileData": {
            "mimeType": "image/jpeg",
            "fileUri": "https://example.com/demo.jpg"
          }
        }
      ]
    }
  ]
}

Ses Giriş ÖrneğiCopy Anchor Link

Bir ses URL'si kullanın:

{
  "contents": [
    {
      "role": "user",
      "parts": [
        { "text": "Transcribe and summarize this audio." },
        {
          "file_data": {
            "mime_type": "audio/mpeg",
            "file_uri": "https://example.com/sample.mp3"
          }
        }
      ]
    }
  ]
}

Video Giriş ÖrneğiCopy Anchor Link

Bir video URL'si kullanın:

{
  "contents": [
    {
      "role": "user",
      "parts": [
        { "text": "Describe this video briefly." },
        {
          "fileData": {
            "mimeType": "video/mp4",
            "fileUri": "https://example.com/sample.mp4"
          }
        }
      ]
    }
  ]
}

{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [
          {"text": "Hello! How can I assist you today?"}
        ]
      },
      "finishReason": "STOP",
      "safetyRatings": [
        {"category": "HARM_CATEGORY_HARASSMENT", "probability": "NEGLIGIBLE"}
      ]
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 5,
    "candidatesTokenCount": 10,
    "totalTokenCount": 15
  }
}

İlgili Arayüzler (Related interfaces)Copy Anchor Link

Başka bir arayüz kullanmadan önce seçilen modelin güncel model ayrıntılarını okuyun. Kullanılabilirlik ve istek alanları modele bağlıdır.

Token sayımı bir API anahtarı gerektirir ve ücretlendirilmez. Döndürülen giriş sayısı planlama için bir tahmindir; ücretlendirme için nihai yanıt kullanımını ve faturalandırma kaydını kullanın.

countTokens: contents / generateContentRequest

embedContent: content, taskType, title, outputDimensionality

batchEmbedContents: requests