Gemini native
Hasilkan Konten
Menghasilkan konten menggunakan format Google Gemini API
Gunakan format request dan response Gemini dengan model yang dikembalikan oleh Daftar Model. Format ProtoJSON lowerCamelCase dan nama field proto snake_case yang sesuai dapat diterima. Field dan nilai opsional yang didukung bergantung pada model yang dipilih.
Parameter Path
Nama model (misalnya, gemini-2.5-pro, gemini-3.5-flash).
Parameter Query
API key (alternatif untuk autentikasi header).
Autentikasi
Endpoint Gemini mendukung beberapa metode autentikasi:
- Parameter query
?key=YOUR_API_KEY - Header
x-goog-api-key: YOUR_API_KEY - Header
Authorization: Bearer YOUR_API_KEY
Body Permintaan
Konten percakapan dengan parts dan role opsional. Bagian media menggunakan inlineData / inline_data atau fileData / file_data. File dan ID Cache yang dibuat oleh TokenLab hanya dapat digunakan di Workspace pemiliknya.
Instruksi sistem untuk model.
Pengaturan pembuatan (generation) seperti temperature, topP, topK, maxOutputTokens, stopSequences, candidateCount, responseModalities, responseMimeType, responseSchema, dan thinkingConfig. Nama snake_case yang sesuai juga diterima. Nilai dan kombinasi yang didukung bergantung pada model.
Pengaturan filter keamanan.
Tools Gemini seperti functionDeclarations. Jenis tool yang didukung bergantung pada model.
Konfigurasi tool seperti functionCallingConfig.
Nama konten yang di-cache yang dibuat dengan Buat konten yang di-cache, misalnya cachedContents/abc123. Ini hanya berfungsi di Workspace yang membuatnya.
Setiap field lowerCamelCase yang ditampilkan di atas juga dapat menggunakan penulisan resmi proto snake_case, misalnya system_instruction, generation_config, safety_settings, tool_config, cached_content, file_data.file_uri, dan inline_data.mime_type.
Metode yang Didukung
API yang kompatibel dengan Gemini mencakup Daftar Model, Dapatkan Model, generateContent, streamGenerateContent, countTokens, File, dan konten yang di-cache. Gemini Interactions dan Live tidak tersedia.
Baca respons Dapatkan Model dari model sebelum memanggilnya: supportedGenerationMethods mencantumkan tindakan yang diterima oleh model tersebut.
Respons
Kandidat konten yang dihasilkan.
Informasi penggunaan token.
Permintaan
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
}
}'Error
400 INVALID_ARGUMENT: body tidak valid, atau model tidak menerima request Gemini.401 UNAUTHENTICATED: API key tidak ada atau tidak valid.402 RESOURCE_EXHAUSTED: saldo terlalu rendah untuk request ini.503 UNAVAILABLE: tidak ada rute yang tersedia untuk model saat ini. Coba lagi nanti.
Input Media
Tempatkan media di dalam contents[].parts[] sebagai byte Base64 inline (inlineData atau inline_data) atau sebagai URL https publik (fileData atau file_data). Gambar, audio, dan video didukung.
Gambar
Gunakan byte gambar inline:
{
"contents": [
{
"role": "user",
"parts": [
{ "text": "Please describe this image." },
{
"inlineData": {
"mimeType": "image/jpeg",
"data": "/9j/4AAQSkZJRgABAQ..."
}
}
]
}
]
}Gunakan URL gambar:
{
"contents": [
{
"role": "user",
"parts": [
{ "text": "Please describe this image." },
{
"fileData": {
"mimeType": "image/jpeg",
"fileUri": "https://example.com/demo.jpg"
}
}
]
}
]
}Audio
Gunakan URL audio, di sini dengan nama proto snake_case:
{
"contents": [
{
"role": "user",
"parts": [
{ "text": "Transcribe and summarize this audio." },
{
"file_data": {
"mime_type": "audio/mpeg",
"file_uri": "https://example.com/sample.mp3"
}
}
]
}
]
}Video
Gunakan URL video:
{
"contents": [
{
"role": "user",
"parts": [
{ "text": "Describe this video briefly." },
{
"fileData": {
"mimeType": "video/mp4",
"fileUri": "https://example.com/sample.mp4"
}
}
]
}
]
}Respons
{
"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
}
}Penghitungan token dan embedding
Hitung Token (POST /v1beta/models/{model}:countTokens) memerlukan API key dan tidak dikenakan biaya. Gunakan jumlah tersebut untuk perencanaan; biaya untuk request pembuatan (generation) berasal dari usageMetadata pada respons tersebut.
Model embedding menggunakan Buat Embedding (POST /v1/embeddings). Panggil embedContent atau batchEmbedContents hanya untuk model yang mencantumkannya dalam supportedGenerationMethods pada respons Dapatkan Model.
Autentikasi API Key. Buat atau kelola API key di Dashboard > API > API Keys.
Lokasi: header
Parameter path
Nama model (contoh: gemini-2.5-pro)
Parameter query
Kunci API (alternatif untuk autentikasi header)
Header
Kebijakan Pengiriman per-permintaan. Menggantikan default API key dan Workspace. Secara otomatis mencoba TokenLab Verified terlebih dahulu dan dapat beralih satu kali ke Official saja sebelum output, penerimaan permintaan, atau pembuatan sumber daya persisten.
Nilai yang tersedia
- "auto"
- "verified"
- "official"
Body permintaan
application/json
Permintaan GenerateContent Gemini asli. Nama ProtoJSON lowerCamelCase dan proto snake_case asli keduanya diterima dan dipertahankan, termasuk permintaan campuran. Jika kedua ejaan dari satu bidang ada, TokenLab tidak menggabungkannya atau memilih prioritas lokal. Bidang yang tidak diketahui diteruskan berdasarkan upaya terbaik.
Respons
application/json
application/json
application/json
application/json
application/json
application/json