Modelos de textoUsuários avançadosAtualizado em
POST/v1beta/models/gemini-3.1-pro-preview:generateContent

Console da API

POST/v1beta/models/gemini-3.1-pro-preview:generateContent
Ver chaves

As requisições usam a chave informada e seguem a cobrança padrão da API.

Gemini 3.1 Pro

ID da solicitação gemini-3.1-pro-preview

Protocolos

Autenticação

Obtenha uma chave em Gerenciar chaves de API. Para requisições JSON, defina Content-Type: application/json.

  • Gemini · x-goog-api-key: YOUR_API_KEY

Parâmetros da requisição

POST /v1beta/models/gemini-3.1-pro-preview:generateContent

CampoTipoObrigatórioDescrição
model (path)stringObrigatórioUse gemini-3.1-pro-preview como ID do modelo no caminho da URL.
contentsobject[]ObrigatórioConteúdo da conversa em ordem. Cada item reúne suas partes de entrada em parts.
contents[].rolestringOpcionalPapel da mensagem. Use user para a entrada do usuário e model para mensagens anteriores do modelo.
contents[].partsobject[]ObrigatórioArray de partes dentro de um item de conteúdo. Partes de texto usam text.
systemInstructionobjectOpcionalObjeto de instrução de sistema. Coloque o texto das instruções em parts[].text.
generationConfig.maxOutputTokensintegerOpcionalLimita o número de tokens de saída. O limite aceito depende do modelo e do endpoint.
generationConfig.temperaturenumberCondicionalControla a aleatoriedade da amostragem. Os valores aceitos e a aplicação do campo dependem do modelo e do endpoint.
generationConfig.topPnumberCondicionalLimita candidatos da amostragem por probabilidade acumulada. Use quando o modelo e o endpoint oferecerem suporte.
generationConfig.responseMimeTypestringOpcionalTipo MIME da saída. Use application/json para saída JSON.
generationConfig.responseJsonSchemaobjectCondicionalJSON Schema da saída. Use com responseMimeType: application/json em um endpoint que aceite esquemas.

POST /v1beta/models/gemini-3.1-pro-preview:streamGenerateContent

CampoTipoObrigatórioDescrição
model (path)stringObrigatórioUse gemini-3.1-pro-preview como ID do modelo no caminho da URL.
contentsobject[]ObrigatórioConteúdo da conversa em ordem. Cada item reúne suas partes de entrada em parts.
contents[].rolestringOpcionalPapel da mensagem. Use user para a entrada do usuário e model para mensagens anteriores do modelo.
contents[].partsobject[]ObrigatórioArray de partes dentro de um item de conteúdo. Partes de texto usam text.
systemInstructionobjectOpcionalObjeto de instrução de sistema. Coloque o texto das instruções em parts[].text.
generationConfig.maxOutputTokensintegerOpcionalLimita o número de tokens de saída. O limite aceito depende do modelo e do endpoint.
generationConfig.temperaturenumberCondicionalControla a aleatoriedade da amostragem. Os valores aceitos e a aplicação do campo dependem do modelo e do endpoint.
generationConfig.topPnumberCondicionalLimita candidatos da amostragem por probabilidade acumulada. Use quando o modelo e o endpoint oferecerem suporte.
generationConfig.responseMimeTypestringOpcionalTipo MIME da saída. Use application/json para saída JSON.
generationConfig.responseJsonSchemaobjectCondicionalJSON Schema da saída. Use com responseMimeType: application/json em um endpoint que aceite esquemas.
?altstringOpcionalParâmetro de consulta. Defina como sse para receber o resultado de streamGenerateContent via SSE.

Exemplos de requisição

Defina a chave de API na variável de ambiente local ICODEEASY_API_KEY e escolha um endpoint que aceite chamadas HTTP diretas. Caso o endpoint exija um cliente específico, siga o guia de configuração desse cliente.

Gemini generateContent

bash
curl -sS 'https://api.icodeeasy.cc/v1beta/models/gemini-3.1-pro-preview:generateContent' \
  -H "x-goog-api-key: $ICODEEASY_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "Explain how a rainbow forms in one sentence."
        }
      ]
    }
  ]
}'

Gemini streamGenerateContent

bash
curl -N -sS 'https://api.icodeeasy.cc/v1beta/models/gemini-3.1-pro-preview:streamGenerateContent?alt=sse' \
  -H "x-goog-api-key: $ICODEEASY_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "Explain how a rainbow forms in one sentence."
        }
      ]
    }
  ]
}'

Ler a resposta

  • Gemini generateContent · Leia os trechos de texto em candidates[].content.parts[]. JSON
  • Gemini streamGenerateContent · Analise cada registro SSE e concatene o texto de candidates[].content.parts[]. SSE

Guia completo de integração

Recursos e limites

  • streaming · Compatível

Aliases de compatibilidade e redirecionamentos aposentados

  • gemini-3.1-pro → gemini-3.1-pro-preview (Alias)
  • gemini-3-pro-preview → gemini-3.1-pro-preview (Redirecionamento aposentado)

Catálogo de recursos dos modelos · Ver preços

Guias relacionados

Configuração do Gemini CLI

Instale o Gemini CLI, configure autenticação e domínio personalizado e use corretamente JSON estrito sem streaming, respostas SSE e a demonstração de análise de vídeo.

Gemini generateContent

Use a API nativa do Gemini com respostas JSON ou streaming via SSE. Informe o ID do modelo no caminho e o texto em contents[].parts[].

Catálogo de recursos dos modelos

Compare modelos públicos de texto, imagem e vídeo por ID normalizado, protocolos, clientes, ferramentas, recursos de mídia, limites e data de revisão.

Criar conta e obter uma API Key