Yang akan Anda bangun
Anda akan mengirim permintaan native GeminiPOST /v1beta/models/\{model\}:generateContent, lalu membandingkannya dengan opsi POST /v1/chat/completions yang kompatibel dengan OpenAI untuk aplikasi yang sudah menggunakan bentuk permintaan Chat Completions.
Prasyarat
- Kunci API CometAPI yang disimpan di
COMETAPI_KEY - Sebuah model ID teks Gemini dari halaman Models
curl, Python 3.10+, atau Node.js 18+
Kunci API, base URL, autentikasi
Gunakan endpoint native Gemini saat Anda menginginkan field permintaan Gemini:x-goog-api-key untuk permintaan HTTP native Gemini langsung:
Format Gemini native
Permintaan Gemini native menggunakancontents, parts, dan generationConfig. Gunakan path ini saat Anda memerlukan field khusus Gemini seperti kontrol thinking, media parts, grounding Google Search, atau operator Streaming native.
Opsi kompatibel OpenAI
Gunakan rute yang kompatibel dengan OpenAI saat Anda memigrasikan OpenAI SDK atau aplikasi Chat Completions yang sudah ada dan tidak memerlukan field permintaan native Gemini.Penjelasan alur
Jangan mencampur dua format permintaan ini. Field native Gemini seperti
contents dan generationConfig digunakan pada rute generateContent. Field Chat Completions seperti messages digunakan pada rute yang kompatibel dengan OpenAI.
Pemecahan masalah / FAQ
Path mana yang sebaiknya saya mulai gunakan
Path mana yang sebaiknya saya mulai gunakan
Mulailah dengan
generateContent native Gemini saat Anda membangun workflow Gemini baru. Gunakan rute yang kompatibel dengan OpenAI saat aplikasi yang sudah ada sudah bergantung pada OpenAI SDK atau bentuk permintaan Chat Completions.Field native Gemini gagal di Chat Completions
Field native Gemini gagal di Chat Completions
Kirim permintaan
contents, parts, generationConfig, dan streamGenerateContent ke endpoint native Gemini. Rute yang kompatibel dengan OpenAI mengharapkan messages dan parameter Chat Completions.Model ID Gemini gagal
Model ID Gemini gagal
Pastikan model ID tersebut tersedia untuk akun Anda dan mendukung rute yang Anda panggil. Gunakan halaman Models untuk menemukan model ID yang tersedia saat ini.
SDK mengarah ke layanan yang salah
SDK mengarah ke layanan yang salah
Untuk permintaan Google GenAI SDK, setel base URL ke
https://api.cometapi.com. Untuk permintaan OpenAI SDK, setel base_url di Python atau baseURL di Node.js ke https://api.cometapi.com/v1.Langkah berikutnya
- Gunakan referensi API native Gemini untuk field permintaan dan respons
generateContentyang lengkap. - Baca referensi API Chat Completions untuk bentuk permintaan yang kompatibel dengan OpenAI.
- Konfigurasikan klien OpenAI SDK di Gunakan CometAPI dengan OpenAI SDK.
- Daftarkan model yang tersedia dengan Daftar model CometAPI yang tersedia.
- Tambahkan penanganan retry dan rate-limit dengan Kode error dan strategi retry.