Modelos de textoUsuários avançadosAtualizado em
POST/v1beta/models/gemini-4-carbon:generateContent

Console da API

POST/v1beta/models/gemini-4-carbon:generateContent
Ver chaves

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

Gemini 4 Carbon

ID da solicitação gemini-4-carbon

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-4-carbon:generateContent

CampoTipoObrigatórioDescrição
model (path)stringObrigatórioUse gemini-4-carbon 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.
contents[].parts[].inlineDataobjectCondicionalObjeto de mídia embutida. Informe mimeType e data em Base64. Os tipos aceitos dependem do modelo e do endpoint.
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.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.
toolsobject[]CondicionalDefinições das ferramentas disponíveis ao modelo. Os tipos de ferramenta e formatos de parâmetros dependem do protocolo e do endpoint.

POST /v1beta/models/gemini-4-carbon:streamGenerateContent

CampoTipoObrigatórioDescrição
model (path)stringObrigatórioUse gemini-4-carbon 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.
contents[].parts[].inlineDataobjectCondicionalObjeto de mídia embutida. Informe mimeType e data em Base64. Os tipos aceitos dependem do modelo e do endpoint.
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.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.
toolsobject[]CondicionalDefinições das ferramentas disponíveis ao modelo. Os tipos de ferramenta e formatos de parâmetros dependem do protocolo e do endpoint.
?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-4-carbon: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-4-carbon: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
  • tool_calling · Condicional — Depende do protocolo compatível e do formato da solicitação
  • image_input · Condicional — Depende do endpoint compatível e do formato da solicitação
  • video_input · Condicional — Depende do endpoint compatível e do formato da solicitação

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