Gemini yerel

İçerik Oluştur

Google Gemini API formatını kullanarak içerik üretir

POST
/v1beta/models/{model}:generateContent

Modelleri Listele tarafından döndürülen bir modelle Gemini istek ve yanıt formatlarını kullanın. ProtoJSON lowerCamelCase ve bunlara 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.

Path Parametreleri

modelstringpathzorunlu

Model adı (örn. gemini-2.5-pro, gemini-3.5-flash).

Query Parametreleri

keystringquery

API anahtarı (header kimlik doğrulamasına alternatif).

Kimlik Doğrulama

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

  • ?key=YOUR_API_KEY query parametresi
  • x-goog-api-key: YOUR_API_KEY header'ı
  • Authorization: Bearer YOUR_API_KEY header'ı

İstek Gövdesi

contentsarrayzorunlu

parts ve isteğe bağlı bir role içeren konuşma içerikleri. Medya parçaları inlineData / inline_data veya fileData / file_data kullanır. TokenLab tarafından oluşturulan Dosyalar ve Cache ID'leri yalnızca ait oldukları Workspace içinde kullanılabilir.

systemInstructionobject

Model için sistem talimatı.

generationConfigobject

temperature, topP, topK, maxOutputTokens, stopSequences, candidateCount, responseModalities, responseMimeType, responseSchema ve thinkingConfig gibi üretim ayarları. Karşılık gelen snake_case adları da kabul edilir. Desteklenen değerler ve kombinasyonlar modele bağlıdır.

safetySettingsarray

Güvenlik filtresi ayarları.

toolsarray

functionDeclarations gibi Gemini araçları. Desteklenen araç türleri modele bağlıdır.

toolConfigobject

functionCallingConfig gibi araç yapılandırması.

cachedContentstring

Önbelleğe alınmış içerik oluştur ile oluşturulan önbelleğe alınmış içeriğin adı, örneğin cachedContents/abc123. Yalnızca onu oluşturan Workspace içinde çalışır.

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

Gemini uyumlu API; Modelleri Listele, Modeli Al, generateContent, streamGenerateContent, countTokens, Dosyalar ve önbelleğe alınmış içeriği içerir. Gemini Interactions ve Live kullanılamaz.

Modeli çağırmadan önce modelin Modeli Al yanıtını inceleyin: supportedGenerationMethods, modelin kabul ettiği eylemleri listeler.

Yanıt

candidatesarray

Oluşturulan içerik adayları.

usageMetadataobject

Token kullanım bilgileri.

İstek

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
    }
  }'

Hatalar

  • 400 INVALID_ARGUMENT: gövde geçerli değil veya model Gemini isteklerini kabul etmiyor.
  • 401 UNAUTHENTICATED: API anahtarı eksik veya geçersiz.
  • 402 RESOURCE_EXHAUSTED: bakiye bu istek için çok düşük.
  • 503 UNAVAILABLE: şu anda model için kullanılabilir rota yok. Daha sonra tekrar deneyin.

Medya Girişi

Medyayı contents[].parts[] içine satır içi Base64 baytları (inlineData veya inline_data) ya da herkese açık bir https URL'si (fileData veya file_data) olarak yerleştirin. Resim, ses ve video desteklenir.

Resim

Satır içi resim baytlarını kullanın:

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

Bir resim URL'si kullanın:

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

Ses

Bir ses URL'si kullanın, burada proto snake_case adlarıyla:

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

Video

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"
          }
        }
      ]
    }
  ]
}

Yanıt

Response
{
  "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
  }
}

Token sayımı ve embedding'ler

Token Say (POST /v1beta/models/{model}:countTokens) bir API anahtarı gerektirir ve faturalandırılmaz. Sayımı planlama için kullanın; üretim isteği ücreti, ilgili yanıtın usageMetadata değerinden alınır.

Embedding modelleri Embedding Oluştur (POST /v1/embeddings) kullanır. embedContent veya batchEmbedContents işlevini yalnızca Modeli Al yanıtında supportedGenerationMethods altında bunları listeleyen bir model için çağırın.

Yetkilendirme

AuthorizationBearer <token>

API Anahtarı kimlik doğrulaması. API anahtarlarını Dashboard > API > API Keys bölümünden oluşturun veya yönetin.

Konum: header

Yol parametreleri

model*string

Model adı (ör. gemini-2.5-pro)

Sorgu parametreleri

key?string

API anahtarı (başlık kimlik doğrulamasına alternatif)

Başlıklar

X-TokenLab-Delivery-Policy?string

İstek bazlı Teslimat politikası. API anahtarı ve Çalışma Alanı varsayılanlarını geçersiz kılar. Otomatik olarak önce TokenLab Verified dener ve çıktı, istek kabulü veya kalıcı kaynak oluşturma öncesinde bir kez Official seçeneğine geçiş yapabilir.

Geçerli değerler

  • "auto"
  • "verified"
  • "official"

İstek gövdesi

application/json

Yerel Gemini GenerateContent isteği. ProtoJSON lowerCamelCase ve orijinal proto snake_case isimlerinin her ikisi de kabul edilir ve korunur; karma istekler dahil. Bir alanın her iki yazımı da mevcutsa, TokenLab bunları birleştirmez veya yerel bir öncelik belirlemez. Bilinmeyen alanlar en iyi çaba esasına göre iletilir.

Yanıt

application/json

application/json

application/json

application/json

application/json

application/json