Tạo nội dung

Sử dụng các định dạng yêu cầu và phản hồi của Gemini với một model được trả về từ Gemini Models API. Các tên trường ProtoJSON lowerCamelCase và tên trường snake_case tương ứng đều được chấp nhận. Các trường và giá trị tùy chọn được hỗ trợ phụ thuộc vào model đã chọn.

Tham số đường dẫn (Path Parameters)Copy Anchor Link

Tham số truy vấn (Query Parameters)Copy Anchor Link

Xác thực (Authentication)Copy Anchor Link

Các endpoint của Gemini hỗ trợ nhiều phương thức xác thực:

• Tham số truy vấn ?key=YOUR_API_KEY
• Header x-goog-api-key: YOUR_API_KEY
• Header Authorization: Bearer YOUR_API_KEY

Thân yêu cầu (Request Body)Copy Anchor Link

Mọi trường lowerCamelCase được hiển thị ở trên cũng có thể sử dụng cách viết snake_case proto chính thức của chúng, ví dụ: system_instruction, generation_config, safety_settings, tool_config, cached_content, file_data.file_uri, và inline_data.mime_type.

Các phương thức được hỗ trợCopy Anchor Link

API tương thích với Gemini bao gồm liệt kê/lấy thông tin model, generateContent, streamGenerateContent, countTokens, embedContent, và batchEmbedContents. Các tính năng Gemini Interactions và Live hiện không khả dụng.

Phản hồi (Response)Copy Anchor Link

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
    }
  }'

Ví dụ về đầu vào VisionCopy Anchor Link

Đối với các yêu cầu đa phương thức (multimodal) của Gemini, hãy đặt phương tiện vào bên trong contents[].parts[] bằng cách sử dụng byte nội tuyến hoặc tham chiếu tệp dựa trên URL.

Các danh mục phương tiện được hỗ trợ trong hợp đồng Gemini công khai:

• image
• audio
• video

Đối với phương tiện nội tuyến, hãy sử dụng inlineData hoặc inline_data và truyền byte tệp đã mã hóa Base64.

Đối với phương tiện dựa trên URL, hãy sử dụng fileData hoặc file_data và truyền một URL https công khai.

Ví dụ về đầu vào VideoCopy Anchor Link

{
  "contents": [
    {
      "role": "user",
      "parts": [
        { "text": "Please describe this video." },
        {
          "fileData": {
            "mimeType": "video/mp4",
            "fileUri": "https://example.com/demo.mp4"
          }
        }
      ]
    }
  ]
}

Ví dụ về đầu vào AudioCopy Anchor Link

{
  "contents": [
    {
      "role": "user",
      "parts": [
        { "text": "Please describe this audio." },
        {
          "fileData": {
            "mimeType": "audio/mpeg",
            "fileUri": "https://example.com/demo.mp3"
          }
        }
      ]
    }
  ]
}

Ví dụ về đầu vào ImageCopy Anchor Link

Sử dụng byte hình ảnh nội tuyến:

{
  "contents": [
    {
      "role": "user",
      "parts": [
        { "text": "Please describe this image." },
        {
          "inlineData": {
            "mimeType": "image/jpeg",
            "data": "/9j/4AAQSkZJRgABAQ..."
          }
        }
      ]
    }
  ]
}

Sử dụng URL hình ảnh:

{
  "contents": [
    {
      "role": "user",
      "parts": [
        { "text": "Please describe this image." },
        {
          "fileData": {
            "mimeType": "image/jpeg",
            "fileUri": "https://example.com/demo.jpg"
          }
        }
      ]
    }
  ]
}

Ví dụ về đầu vào AudioCopy Anchor Link

Sử dụng URL âm thanh:

{
  "contents": [
    {
      "role": "user",
      "parts": [
        { "text": "Transcribe and summarize this audio." },
        {
          "file_data": {
            "mime_type": "audio/mpeg",
            "file_uri": "https://example.com/sample.mp3"
          }
        }
      ]
    }
  ]
}

Ví dụ về đầu vào VideoCopy Anchor Link

Sử dụng URL video:

{
  "contents": [
    {
      "role": "user",
      "parts": [
        { "text": "Describe this video briefly." },
        {
          "fileData": {
            "mimeType": "video/mp4",
            "fileUri": "https://example.com/sample.mp4"
          }
        }
      ]
    }
  ]
}

{
  "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
  }
}

Các giao diện liên quanCopy Anchor Link

Đọc chi tiết về model đã chọn trước khi sử dụng giao diện khác. Tính khả dụng và các trường yêu cầu phụ thuộc vào model.

Việc đếm token yêu cầu API key và không bị tính phí. Số lượng đầu vào được trả về là ước tính để lập kế hoạch; hãy sử dụng dữ liệu sử dụng và hồ sơ thanh toán trong phản hồi cuối cùng để tính phí.

countTokens: contents / generateContentRequest

embedContent: content, taskType, title, outputDimensionality

batchEmbedContents: requests