Neler oluşturacaksınız
Native bir GeminiPOST /v1beta/models/\{model\}:generateContent isteği gönderecek, ardından bunu, zaten Chat Completions istek biçimlerini kullanan uygulamalar için OpenAI-compatible POST /v1/chat/completions seçeneğiyle karşılaştıracaksınız.
Ön koşullar
COMETAPI_KEYiçinde saklanan bir CometAPI API anahtarı- Models page üzerinden bir Gemini metin model ID
curl, Python 3.10+ veya Node.js 18+
API anahtarı, base URL, kimlik doğrulama
Gemini istek alanlarını kullanmak istediğinizde Gemini native endpoint’ini kullanın:x-goog-api-key kullanın:
Native Gemini biçimi
Native Gemini isteklericontents, parts ve generationConfig kullanır. Thinking kontrolleri, medya parçaları, Google Search grounding veya native streaming operatörleri gibi Gemini’ye özgü alanlara ihtiyaç duyduğunuzda bu yolu kullanın.
OpenAI-compatible seçenek
Mevcut bir OpenAI SDK veya Chat Completions uygulamasını taşıyorsanız ve Gemini native istek alanlarına ihtiyacınız yoksa OpenAI-compatible rotayı kullanın.Akış açıklaması
İki istek biçimini birbiriyle karıştırmayın.
contents ve generationConfig gibi native Gemini alanları generateContent rotasına aittir. messages gibi Chat Completions alanları OpenAI-compatible rotaya aittir.
Sorun giderme / SSS
Hangi yolla başlamalıyım
Hangi yolla başlamalıyım
Yeni bir Gemini iş akışı oluşturuyorsanız native Gemini
generateContent ile başlayın. Mevcut bir uygulama zaten OpenAI SDK veya Chat Completions istek biçimlerine bağlıysa OpenAI-compatible rotayı kullanın.Native Gemini alanları Chat Completions üzerinde başarısız oluyor
Native Gemini alanları Chat Completions üzerinde başarısız oluyor
contents, parts, generationConfig ve streamGenerateContent isteklerini Gemini native endpoint’ine gönderin. OpenAI-compatible rota messages ve Chat Completions parametreleri bekler.Gemini model ID başarısız oluyor
Gemini model ID başarısız oluyor
model ID’nin hesabınız için kullanılabilir olduğunu ve çağırdığınız rotayı desteklediğini doğrulayın. Güncel model ID’leri bulmak için Models page sayfasını kullanın.
SDK yanlış servise işaret ediyor
SDK yanlış servise işaret ediyor
Google GenAI SDK istekleri için base URL’yi
https://api.cometapi.com olarak ayarlayın. OpenAI SDK istekleri için Python’da base_url veya Node.js’te baseURL değerini https://api.cometapi.com/v1 olarak ayarlayın.Sonraki adımlar
- Tam
generateContentistek ve yanıt alanları için Gemini native API reference belgesini kullanın. - OpenAI-compatible istek biçimi için Chat Completions API reference belgesini okuyun.
- OpenAI SDK istemcilerini Use CometAPI with OpenAI SDKs içinde yapılandırın.
- Kullanılabilir modelleri List available CometAPI models ile listeleyin.
- Error codes and retry strategy ile yeniden deneme ve rate-limit işlemelerini ekleyin.