Gemini native

Hasilkan Konten

Menghasilkan konten menggunakan format Google Gemini API

POST
/v1beta/models/{model}:generateContent

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

modelstringpathwajib

Nama model (misalnya, gemini-2.5-pro, gemini-3.5-flash).

Parameter Query

keystringquery

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

contentsarraywajib

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.

systemInstructionobject

Instruksi sistem untuk model.

generationConfigobject

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.

safetySettingsarray

Pengaturan filter keamanan.

toolsarray

Tools Gemini seperti functionDeclarations. Jenis tool yang didukung bergantung pada model.

toolConfigobject

Konfigurasi tool seperti functionCallingConfig.

cachedContentstring

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

candidatesarray

Kandidat konten yang dihasilkan.

usageMetadataobject

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

Response
{
  "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.

Otorisasi

AuthorizationBearer <token>

Autentikasi API Key. Buat atau kelola API key di Dashboard > API > API Keys.

Lokasi: header

Parameter path

model*string

Nama model (contoh: gemini-2.5-pro)

Parameter query

key?string

Kunci API (alternatif untuk autentikasi header)

Header

X-TokenLab-Delivery-Policy?string

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