Gemini Dosyaları ve Önbelleğe Alınmış İçerik

Bu yerel Gemini kaynaklarını, gereken işlemi destekleyen güncel bir TokenLab modeliyle kullanın. Aşağıdaki yollar Gemini API biçimini izler.

Workspace ve desteklenen modellerCopy Anchor Link

Dosyalar ve önbelleğe alınmış içerik, kimliği doğrulanmış isteğin Workspace’ine aittir. Kaynakları aynı Workspace’ten oluşturun, listeleyin, okuyun, referans verin, güncelleyin ve silin. Kaynak adı veya dosya URI’si sahipliği aktarmaz.

DosyalarCopy Anchor Link

Desteklenen mevcut bir kaynağı kaydetmek için register kullanın; bu işlem yerel dosya baytlarını yüklemez. Gerekirse JSON ile metadata oluşturun ve dosya baytlarını yükleme uç noktasına gönderin. Listeleme veya okuma ile durumu kontrol edin; Gemini içeriğinde dönen URI’yi kullanmadan önce dosyanın hazır olmasını bekleyin. Artık gerekmeyen dosyaları silin.

Önbelleğe alınmış içerikCopy Anchor Link

Desteklenen bir model için contents ve gerekirse sistem talimatı, araçlar, araç yapılandırması ve TTL ya da sona erme zamanı içeren önbellek oluşturun. Aynı Workspace’ten yapılan sonraki Gemini generateContent isteğinde dönen name değerini cachedContent olarak kullanın. GET ve listeleme önbellek metadata’sını okur; PATCH kullanım süresini günceller; DELETE sonrasında içerik sonraki üretimlerde kullanılamaz.

Devam ettirilebilir yüklemelerCopy Anchor Link

Devam ettirilebilir yükleme için metadata’yı başlatma uç noktasına POST edin ve X-Goog-Upload-Protocol: resumable ile X-Goog-Upload-Command: start başlıklarını ayarlayın. Yanıt başlığı X-Goog-Upload-URL değerini aynen alın ve her bayt parçasını yükleme komutu ile onaylanan ofseti ekleyerek bu URL’ye POST edin. URL özel bir yetki bilgisidir, bir saat sonra sona erer ve devam iznini kendi başına sağlar. Yayımlamayın, günlüğe yazmayın veya paylaşmayın. Sıradan bir HTTP yönlendirmesi gibi takip etmeyin.

HTTP 308, parçanın kabul edildiğini ancak yüklemenin tamamlanmadığını belirtir: aynı URL’de devam edin ve başarı olarak değerlendirmeyin. HTTP 404 oturumun bulunmadığını veya süresinin dolduğunu belirtir. HTTP 410 oturumun artık sürdürülemeyeceğini belirtir; yeni bir yükleme oturumu başlatın. Yüklemeyi yalnızca dosya kaynağını içeren son başarılı yanıtla tamamlanmış sayın.

SDK yapılandırmasıCopy Anchor Link

TOKENLAB_API_KEY değerini işlem ortamında ayarlayın. Google Gen AI SDK’yi TokenLab ana bilgisayarını ve Gemini API sürümünü kullanacak şekilde yapılandırın:

import os
from google import genai

client = genai.Client(
    api_key=os.environ["TOKENLAB_API_KEY"],
    http_options={"base_url": "https://api.tokenlab.sh", "api_version": "v1beta"},
)

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

const client = new GoogleGenAI({
  apiKey: process.env.TOKENLAB_API_KEY,
  httpOptions: { baseUrl: "https://api.tokenlab.sh", apiVersion: "v1beta" },
});

Anahtarı veya yükleme URL’sini kaynak koduna, tarayıcı depolamasına ya da günlüklere koymayın.

12 işlemCopy Anchor Link

Liste uç noktaları pageSize ve pageToken destekler. Sonraki Gemini isteğinde dönen önbellek adını cachedContent olarak kullanın. Tüm alanlar için OpenAPI belirtimine ve model ayrıntılarına bakın.