Skip to main content

Neler oluşturacaksınız

Native bir Gemini POST /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_KEY iç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:
Doğrudan native Gemini HTTP istekleri için x-goog-api-key kullanın:
OpenAI-compatible base URL’yi yalnızca uygulamanız zaten Chat Completions kullanıyorsa kullanın:

Native Gemini biçimi

Native Gemini istekleri contents, 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

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.
contents, parts, generationConfig ve streamGenerateContent isteklerini Gemini native endpoint’ine gönderin. OpenAI-compatible rota messages ve Chat Completions parametreleri bekler.
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.
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