Gemini yerel
İçerik Oluştur
Google Gemini API formatını kullanarak içerik üretir
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
Model adı (örn. gemini-2.5-pro, gemini-3.5-flash).
Query Parametreleri
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_KEYquery parametresix-goog-api-key: YOUR_API_KEYheader'ıAuthorization: Bearer YOUR_API_KEYheader'ı
İstek Gövdesi
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.
Model için sistem talimatı.
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.
Güvenlik filtresi ayarları.
functionDeclarations gibi Gemini araçları. Desteklenen araç türleri modele bağlıdır.
functionCallingConfig gibi araç yapılandırması.
Ö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
Oluşturulan içerik adayları.
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
{
"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.
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 adı (ör. gemini-2.5-pro)
Sorgu parametreleri
API anahtarı (başlık kimlik doğrulamasına alternatif)
Başlıklar
İ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