Skip to main content

Yang akan Anda bangun

Anda akan mengirim permintaan native Gemini POST /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:
Gunakan x-goog-api-key untuk permintaan HTTP native Gemini langsung:
Gunakan base URL yang kompatibel dengan OpenAI hanya jika aplikasi Anda sudah menggunakan Chat Completions:

Format Gemini native

Permintaan Gemini native menggunakan contents, 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

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.
Kirim permintaan contents, parts, generationConfig, dan streamGenerateContent ke endpoint native Gemini. Rute yang kompatibel dengan OpenAI mengharapkan messages dan parameter Chat Completions.
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.
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