Gerar Conteúdo

Use os formatos de solicitação e resposta do Gemini com um modelo retornado pela API de Modelos do Gemini. Nomes de campos em lowerCamelCase do ProtoJSON e os nomes de campos correspondentes em snake_case do proto são aceitos. Os campos opcionais e valores suportados dependem do modelo selecionado.

Parâmetros de CaminhoCopy Anchor Link

Parâmetros de ConsultaCopy Anchor Link

AutenticaçãoCopy Anchor Link

Os endpoints do Gemini suportam vários métodos de autenticação:

• Parâmetro de consulta ?key=YOUR_API_KEY
• Cabeçalho x-goog-api-key: YOUR_API_KEY
• Cabeçalho Authorization: Bearer YOUR_API_KEY

Corpo da SolicitaçãoCopy Anchor Link

Cada campo em lowerCamelCase mostrado acima também pode usar sua grafia oficial em snake_case do proto, por exemplo: system_instruction, generation_config, safety_settings, tool_config, cached_content, file_data.file_uri e inline_data.mime_type.

Métodos SuportadosCopy Anchor Link

A API compatível com o Gemini inclui listagem/obtenção de modelos, generateContent, streamGenerateContent, countTokens, embedContent e batchEmbedContents. As interações Gemini e Live não estão disponíveis.

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

Exemplo de Entrada de VisãoCopy Anchor Link

Para solicitações multimodais do Gemini, coloque a mídia dentro de contents[].parts[] usando bytes inline ou referências de arquivo baseadas em URL.

Categorias de mídia suportadas nos detalhes do modelo do Gemini:

• image
• audio
• video

Para mídia inline, use inlineData ou inline_data e passe os bytes do arquivo codificados em Base64.

Para mídia baseada em URL, use fileData ou file_data e passe uma URL https pública.

Exemplo de Entrada de VídeoCopy Anchor Link

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

Exemplo de Entrada de ÁudioCopy Anchor Link

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

Exemplo de Entrada de ImagemCopy Anchor Link

Use bytes de imagem inline:

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

Use uma URL de imagem:

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

Exemplo de Entrada de ÁudioCopy Anchor Link

Use uma URL de áudio:

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

Exemplo de Entrada de VídeoCopy Anchor Link

Use uma URL de vídeo:

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

Interfaces relacionadasCopy Anchor Link

Leia os detalhes do modelo selecionado antes de usar outra interface. A disponibilidade e os campos de solicitação dependem do modelo.

A contagem de tokens requer uma chave de API e não é cobrada. A contagem de entrada retornada é uma estimativa para planejamento; use o uso da resposta final e o registro de faturamento para a cobrança.

countTokens: contents / generateContentRequest

embedContent: content, taskType, title, outputDimensionality

batchEmbedContents: requests