Gemini API

A API Gemini Interactions é uma API experimental que permite aos desenvolvedores criar aplicativos de IA generativa usando modelos do Gemini. O Gemini é nosso modelo mais avançado, criado desde o início para ser multimodal. Ele pode generalizar, entender, operar e combinar diferentes tipos de informações, incluindo idiomas, imagens, áudio, vídeo e código. Você pode usar a API Gemini para casos de uso como raciocínio em textos e imagens, geração de conteúdo, agentes de diálogo, sistemas de resumo e classificação e muito mais.

Criar uma interação

post https://generativelanguage.googleapis.com/v1beta/interactions

Cria uma nova interação.

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

model ModelOption  (opcional)

O nome do "Model" usado para gerar a interação.
Obrigatório se "agent" não for fornecido.

Valores possíveis:

  • gemini-2.5-pro

    Nosso modelo multifuncional de última geração, que se destaca em programação e tarefas de raciocínio complexas.

  • gemini-2.5-flash

    Nosso primeiro modelo de raciocínio híbrido que oferece suporte a uma janela de contexto de 1 milhão de tokens e tem orçamentos de pensamento.

  • gemini-2.5-flash-preview-09-2025

    O modelo mais recente baseado no modelo 2.5 Flash. O pré-lançamento do 2.5 Flash é ideal para processamento em grande escala, baixa latência, tarefas de alto volume que exigem pensamento e casos de uso de agentes.

  • gemini-2.5-flash-lite

    Nosso modelo menor e mais econômico, criado para uso em grande escala.

  • gemini-2.5-flash-lite-preview-09-2025

    O modelo mais recente baseado no Gemini 2.5 Flash lite otimizado para custo-benefício, alta taxa de transferência e alta qualidade.

  • gemini-2.5-flash-preview-native-audio-dialog

    Nossos modelos de áudio nativos são otimizados para saídas de áudio de maior qualidade, com melhor ritmo, naturalidade da voz, nível de detalhes e humor.

  • gemini-2.5-flash-image-preview

    Nosso modelo nativo de geração de imagens, otimizado para velocidade, flexibilidade e compreensão contextual. A entrada e a saída de texto têm o mesmo preço do 2.5 Flash.

  • gemini-2.5-pro-preview-tts

    Nosso modelo de áudio Text-to-Speech 2.5 Pro otimizado para geração de fala potente e de baixa latência, com saídas mais naturais e comandos mais fáceis de direcionar.

  • gemini-3-pro-preview

    Nosso modelo mais inteligente com raciocínio e compreensão multimodal de última geração, além de recursos avançados de programação assistida por IA e vibe coding.

O modelo que vai concluir seu comando.\n\nConsulte [modelos](https://ai.google.dev/gemini-api/docs/models) para mais detalhes.

agent AgentOption  (opcional)

O nome do "Agente" usado para gerar a interação.
Obrigatório se "model" não for fornecido.

Valores possíveis:

  • deep-research-pro-preview-12-2025

    Agente de Deep Research do Gemini

O agente com quem interagir.

input Content ou matriz (Content) ou matriz (Turn) ou string  (obrigatório)

As entradas para a interação (comum ao modelo e ao agente).

system_instruction string  (opcional)

Instrução do sistema para a interação.

tools array (Tool)  (opcional)

Uma lista de declarações de ferramentas que o modelo pode chamar durante a interação.

response_format object  (opcional)

Força que a resposta gerada seja um objeto JSON que esteja em conformidade com o esquema JSON especificado neste campo.

response_mime_type string  (opcional)

O tipo MIME da resposta. Obrigatório se "response_format" estiver definido.

stream boolean  (opcional)

Somente entrada. Se a interação será transmitida por streaming.

store boolean  (opcional)

Somente entrada. Se a resposta e a solicitação serão armazenadas para recuperação posterior.

background boolean  (opcional)

Se a interação do modelo será executada em segundo plano.

generation_config GenerationConfig  (opcional)

Configuração do modelo
: parâmetros de configuração para a interação do modelo.
Alternativa a "agent_config". Só é aplicável quando "model" está definido.

Parâmetros de configuração para interações do modelo.

Campos

temperature number  (opcional)

Controla a aleatoriedade da saída.

top_p number  (opcional)

A probabilidade cumulativa máxima de tokens a serem considerados na amostragem.

seed integer  (opcional)

Seed usada na decodificação para reprodutibilidade.

stop_sequences array (string)  (opcional)

Uma lista de sequências de caracteres que vão interromper a interação de saída.

tool_choice ToolChoice  (opcional)

A escolha da ferramenta para a interação.

A configuração para escolha de ferramentas.

Tipos possíveis

ToolChoiceType

Esse tipo não tem campos específicos.

ToolChoiceConfig

allowed_tools AllowedTools  (opcional)

Nenhuma descrição informada.

A configuração para ferramentas permitidas.

Campos

mode ToolChoiceType  (opcional)

O modo da escolha de ferramenta.

Valores possíveis:

  • auto
  • any
  • none
  • validated

tools array (string)  (opcional)

Os nomes das ferramentas permitidas.

thinking_level ThinkingLevel  (opcional)

O nível de tokens de pensamento que o modelo deve gerar.

Valores possíveis:

  • low
  • high

thinking_summaries ThinkingSummaries  (opcional)

Define se os resumos de pensamento serão incluídos na resposta.

Valores possíveis:

  • auto
  • none

max_output_tokens integer  (opcional)

O número máximo de tokens a serem incluídos na resposta.

speech_config SpeechConfig  (opcional)

Configuração para interação de fala.

A configuração para interação por voz.

Campos

voice string  (opcional)

A voz do alto-falante.

language string  (opcional)

O idioma da fala.

speaker string  (opcional)

O nome do falante precisa corresponder ao nome informado no comando.

agent_config object  (optional)

Configuração do agente
Configuração do agente.
Alternativa a "generation_config". Só é aplicável quando "agent" está definido.

Tipos possíveis

Discriminador polimórfico: type

DynamicAgentConfig

Configuração para agentes dinâmicos.

type string  (opcional)

Usado como o discriminador de tipo OpenAPI para o conteúdo oneof.

Sempre defina como "dynamic".

DeepResearchAgentConfig

Configuração do agente Deep Research.

type string  (opcional)

Usado como o discriminador de tipo OpenAPI para o conteúdo oneof.

Sempre defina como "deep-research".

thinking_summaries ThinkingSummaries  (opcional)

Define se os resumos de pensamento serão incluídos na resposta.

Valores possíveis:

  • auto
  • none

previous_interaction_id string  (opcional)

O ID da interação anterior, se houver.

response_modalities ResponseModality  (opcional)

As modalidades solicitadas da resposta (TEXT, IMAGE, AUDIO).

Valores possíveis:

  • text
  • image
  • audio

Resposta

Retorna um recurso Interaction.

Solicitação simples

Exemplo de resposta

{
  "created": "2025-11-26T12:25:15Z",
  "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg",
  "model": "gemini-2.5-flash",
  "object": "interaction",
  "outputs": [
    {
      "text": "Hello! I'm functioning perfectly and ready to assist you.\n\nHow are you doing today?",
      "type": "text"
    }
  ],
  "role": "model",
  "status": "completed",
  "updated": "2025-11-26T12:25:15Z",
  "usage": {
    "input_tokens_by_modality": [
      {
        "modality": "text",
        "tokens": 7
      }
    ],
    "total_cached_tokens": 0,
    "total_input_tokens": 7,
    "total_output_tokens": 20,
    "total_reasoning_tokens": 22,
    "total_tokens": 49,
    "total_tool_use_tokens": 0
  }
}

Várias interações

Exemplo de resposta

{
  "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg",
  "model": "gemini-2.5-flash",
  "status": "completed",
  "object": "interaction",
  "created": "2025-11-26T12:22:47Z",
  "updated": "2025-11-26T12:22:47Z",
  "role": "model",
  "outputs": [
    {
      "type": "text",
      "text": "The capital of France is Paris."
    }
  ],
  "usage": {
    "input_tokens_by_modality": [
      {
        "modality": "text",
        "tokens": 50
      }
    ],
    "total_cached_tokens": 0,
    "total_input_tokens": 50,
    "total_output_tokens": 10,
    "total_reasoning_tokens": 0,
    "total_tokens": 60,
    "total_tool_use_tokens": 0
  }
}

Entrada de imagem

Exemplo de resposta

{
  "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg",
  "model": "gemini-2.5-flash",
  "status": "completed",
  "object": "interaction",
  "created": "2025-11-26T12:22:47Z",
  "updated": "2025-11-26T12:22:47Z",
  "role": "model",
  "outputs": [
    {
      "type": "text",
      "text": "A white humanoid robot with glowing blue eyes stands holding a red skateboard."
    }
  ],
  "usage": {
    "input_tokens_by_modality": [
      {
        "modality": "text",
        "tokens": 10
      },
      {
        "modality": "image",
        "tokens": 258
      }
    ],
    "total_cached_tokens": 0,
    "total_input_tokens": 268,
    "total_output_tokens": 20,
    "total_reasoning_tokens": 0,
    "total_tokens": 288,
    "total_tool_use_tokens": 0
  }
}

Chamada de função

Exemplo de resposta

{
  "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg",
  "model": "gemini-2.5-flash",
  "status": "requires_action",
  "object": "interaction",
  "created": "2025-11-26T12:22:47Z",
  "updated": "2025-11-26T12:22:47Z",
  "role": "model",
  "outputs": [
    {
      "type": "function_call",
      "function_call": {
        "name": "get_weather",
        "arguments": {
          "location": "Boston, MA"
        }
      }
    }
  ],
  "usage": {
    "input_tokens_by_modality": [
      {
        "modality": "text",
        "tokens": 100
      }
    ],
    "total_cached_tokens": 0,
    "total_input_tokens": 100,
    "total_output_tokens": 25,
    "total_reasoning_tokens": 0,
    "total_tokens": 125,
    "total_tool_use_tokens": 50
  }
}

Deep Research

Exemplo de resposta

{
  "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg",
  "agent": "deep-research-pro-preview-12-2025",
  "status": "completed",
  "object": "interaction",
  "created": "2025-11-26T12:22:47Z",
  "updated": "2025-11-26T12:22:47Z",
  "role": "model",
  "outputs": [
    {
      "type": "text",
      "text": "Here is a comprehensive research report on the current state of cancer research..."
    }
  ],
  "usage": {
    "input_tokens_by_modality": [
      {
        "modality": "text",
        "tokens": 20
      }
    ],
    "total_cached_tokens": 0,
    "total_input_tokens": 20,
    "total_output_tokens": 1000,
    "total_reasoning_tokens": 500,
    "total_tokens": 1520,
    "total_tool_use_tokens": 0
  }
}

Como recuperar uma interação

get https://generativelanguage.googleapis.com/v1beta/interactions/{id}

Recupera todos os detalhes de uma única interação com base no `Interaction.id`.

Parâmetros de caminho / consulta

id string  (obrigatório)

O identificador exclusivo da interação a ser recuperada.

stream boolean  (opcional)

Se definido como verdadeiro, o conteúdo gerado será transmitido de forma incremental.

Padrão: False

last_event_id string  (opcional)

Opcional. Se definido, retoma o fluxo de interação do próximo bloco após o evento marcado pelo ID do evento. Só pode ser usado se "stream" for verdadeiro.

api_version string  (opcional)

Qual versão da API usar.

Resposta

Retorna um recurso Interaction.

Acessar interação

Exemplo de resposta

{
  "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg",
  "model": "gemini-2.5-flash",
  "status": "completed",
  "object": "interaction",
  "created": "2025-11-26T12:25:15Z",
  "updated": "2025-11-26T12:25:15Z",
  "role": "model",
  "outputs": [
    {
      "type": "text",
      "text": "I'm doing great, thank you for asking! How can I help you today?"
    }
  ]
}

Excluir uma interação

delete https://generativelanguage.googleapis.com/v1beta/interactions/{id}

Exclui a interação por ID.

Parâmetros de caminho / consulta

id string  (obrigatório)

O identificador exclusivo da interação a ser excluída.

api_version string  (opcional)

Qual versão da API usar.

Resposta

Se a solicitação for concluída, a resposta estará vazia.

Excluir interação

Como cancelar uma interação

post https://generativelanguage.googleapis.com/v1beta/interactions/{id}/cancel

Cancela uma interação por ID. Isso só se aplica a interações em segundo plano que ainda estão em execução.

Parâmetros de caminho / consulta

id string  (obrigatório)

O identificador exclusivo da interação a ser recuperada.

api_version string  (opcional)

Qual versão da API usar.

Resposta

Retorna um recurso Interaction.

Cancelar interação

Exemplo de resposta

{
  "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg",
  "agent": "deep-research-pro-preview-12-2025",
  "status": "cancelled",
  "object": "interaction",
  "created": "2025-11-26T12:25:15Z",
  "updated": "2025-11-26T12:25:15Z",
  "role": "model"
}

Recursos

Interação

O recurso "Interaction".

Campos

model ModelOption  (opcional)

O nome do "Model" usado para gerar a interação.

Valores possíveis:

  • gemini-2.5-pro

    Nosso modelo multifuncional de última geração, que se destaca em programação e tarefas de raciocínio complexas.

  • gemini-2.5-flash

    Nosso primeiro modelo de raciocínio híbrido que oferece suporte a uma janela de contexto de 1 milhão de tokens e tem orçamentos de pensamento.

  • gemini-2.5-flash-preview-09-2025

    O modelo mais recente baseado no modelo 2.5 Flash. O pré-lançamento do 2.5 Flash é ideal para processamento em grande escala, baixa latência, tarefas de alto volume que exigem pensamento e casos de uso de agentes.

  • gemini-2.5-flash-lite

    Nosso modelo menor e mais econômico, criado para uso em grande escala.

  • gemini-2.5-flash-lite-preview-09-2025

    O modelo mais recente baseado no Gemini 2.5 Flash lite otimizado para custo-benefício, alta taxa de transferência e alta qualidade.

  • gemini-2.5-flash-preview-native-audio-dialog

    Nossos modelos de áudio nativos são otimizados para saídas de áudio de maior qualidade, com melhor ritmo, naturalidade da voz, nível de detalhes e humor.

  • gemini-2.5-flash-image-preview

    Nosso modelo nativo de geração de imagens, otimizado para velocidade, flexibilidade e compreensão contextual. A entrada e a saída de texto têm o mesmo preço do 2.5 Flash.

  • gemini-2.5-pro-preview-tts

    Nosso modelo de áudio Text-to-Speech 2.5 Pro otimizado para geração de fala potente e de baixa latência, com saídas mais naturais e comandos mais fáceis de direcionar.

  • gemini-3-pro-preview

    Nosso modelo mais inteligente com raciocínio e compreensão multimodal de última geração, além de recursos avançados de programação assistida por IA e vibe coding.

O modelo que vai concluir seu comando.\n\nConsulte [modelos](https://ai.google.dev/gemini-api/docs/models) para mais detalhes.

agent AgentOption  (opcional)

O nome do "Agente" usado para gerar a interação.

Valores possíveis:

  • deep-research-pro-preview-12-2025

    Agente de Deep Research do Gemini

O agente com quem interagir.

id string  (opcional)

Apenas saída. Um identificador exclusivo para a conclusão da interação.

status enum (string)  (opcional)

Apenas saída. O status da interação.

Valores possíveis:

  • in_progress
  • requires_action
  • completed
  • failed
  • cancelled
created string  (opcional)

Apenas saída. O horário em que a resposta foi criada no formato ISO 8601 (AAAA-MM-DDThh:mm:ssZ).

updated string  (opcional)

Apenas saída. A hora em que a resposta foi atualizada pela última vez no formato ISO 8601 (AAAA-MM-DDThh:mm:ssZ).

role string  (opcional)

Apenas saída. A função da interação.

outputs array (Content)  (opcional)

Apenas saída. Respostas do modelo.

object string  (opcional)

Apenas saída. O tipo de objeto da interação. Sempre definido como "interaction".

Sempre defina como "interaction".

usage Usage  (opcional)

Apenas saída. Estatísticas sobre o uso de tokens da solicitação de interação.

Estatísticas sobre o uso de tokens da solicitação de interação.

Campos

total_input_tokens integer  (optional)

Número de tokens no comando (contexto).

input_tokens_by_modality ModalityTokens  (opcional)

Um detalhamento do uso de tokens de entrada por modalidade.

A contagem de tokens para uma única modalidade de resposta.

Campos

modalidade ResponseModality  (opcional)

A modalidade associada à contagem de tokens.

Valores possíveis:

  • text
  • image
  • audio

tokens integer  (opcional)

Número de tokens para a modalidade.

total_cached_tokens integer  (optional)

Número de tokens na parte em cache do comando (o conteúdo em cache).

cached_tokens_by_modality ModalityTokens  (opcional)

Um detalhamento do uso de tokens armazenados em cache por modalidade.

A contagem de tokens para uma única modalidade de resposta.

Campos

modalidade ResponseModality  (opcional)

A modalidade associada à contagem de tokens.

Valores possíveis:

  • text
  • image
  • audio

tokens integer  (opcional)

Número de tokens para a modalidade.

total_output_tokens integer  (opcional)

Número total de tokens em todas as respostas geradas.

output_tokens_by_modality ModalityTokens  (opcional)

Uma análise do uso de tokens de saída por modalidade.

A contagem de tokens para uma única modalidade de resposta.

Campos

modalidade ResponseModality  (opcional)

A modalidade associada à contagem de tokens.

Valores possíveis:

  • text
  • image
  • audio

tokens integer  (opcional)

Número de tokens para a modalidade.

total_tool_use_tokens integer  (optional)

Número de tokens presentes nos comandos de uso da ferramenta.

tool_use_tokens_by_modality ModalityTokens  (opcional)

Um detalhamento do uso de tokens de uso de ferramentas por modalidade.

A contagem de tokens para uma única modalidade de resposta.

Campos

modalidade ResponseModality  (opcional)

A modalidade associada à contagem de tokens.

Valores possíveis:

  • text
  • image
  • audio

tokens integer  (opcional)

Número de tokens para a modalidade.

total_reasoning_tokens integer  (opcional)

Número de tokens de ideias para modelos de pensamento.

total_tokens integer  (opcional)

Contagem total de tokens para a solicitação de interação (comando + respostas + outros tokens internos).

previous_interaction_id string  (opcional)

O ID da interação anterior, se houver.

Exemplos

Exemplo

{
  "created": "2025-12-04T15:01:45Z",
  "id": "v1_ChdXS0l4YWZXTk9xbk0xZThQczhEcmlROBIXV0tJeGFmV05PcW5NMWU4UHM4RHJpUTg",
  "model": "gemini-2.5-flash",
  "object": "interaction",
  "outputs": [
    {
      "text": "Hello! I'm doing well, functioning as expected. Thank you for asking! How are you doing today?",
      "type": "text"
    }
  ],
  "role": "model",
  "status": "completed",
  "updated": "2025-12-04T15:01:45Z",
  "usage": {
    "input_tokens_by_modality": [
      {
        "modality": "text",
        "tokens": 7
      }
    ],
    "total_cached_tokens": 0,
    "total_input_tokens": 7,
    "total_output_tokens": 23,
    "total_reasoning_tokens": 49,
    "total_tokens": 79,
    "total_tool_use_tokens": 0
  }
}

Modelos de dados

Conteúdo

O conteúdo da resposta.

Tipos possíveis

Discriminador polimórfico: type

TextContent

Um bloco de conteúdo de texto.

text string  (opcional)

O conteúdo do texto.

type string  (obrigatório)

Usado como o discriminador de tipo OpenAPI para o conteúdo oneof.

Sempre defina como "text".

annotations Annotation  (opcional)

Informações de citação para conteúdo gerado por modelos.

Informações de citação para conteúdo gerado por modelos.

Campos

start_index integer  (opcional)

Início do segmento da resposta atribuído a esta fonte. O índice indica o início do segmento, medido em bytes.

end_index integer  (opcional)

Fim do segmento atribuído, exclusivo.

source string  (opcional)

Origem atribuída a uma parte do texto. Pode ser um URL, um título ou outro identificador.

ImageContent

Um bloco de conteúdo de imagem.

data string  (opcional)

Nenhuma descrição informada.

uri string  (opcional)

Nenhuma descrição informada.

mime_type ImageMimeTypeOption  (opcional)

Nenhuma descrição informada.

Valores possíveis:

  • image/png
  • image/jpeg
  • image/webp
  • image/heic
  • image/heif

O tipo MIME da imagem.

type string  (obrigatório)

Usado como o discriminador de tipo OpenAPI para o conteúdo oneof.

Sempre defina como "image".

resolution MediaResolution  (opcional)

A resolução da mídia.

Valores possíveis:

  • low
  • medium
  • high

AudioContent

Um bloco de conteúdo de áudio.

data string  (opcional)

Nenhuma descrição informada.

uri string  (opcional)

Nenhuma descrição informada.

mime_type AudioMimeTypeOption  (opcional)

Nenhuma descrição informada.

Valores possíveis:

  • audio/wav
  • audio/mp3
  • audio/aiff
  • audio/aac
  • audio/ogg
  • audio/flac

O tipo MIME do áudio.

type string  (obrigatório)

Usado como o discriminador de tipo OpenAPI para o conteúdo oneof.

Sempre defina como "audio".

DocumentContent

Um bloco de conteúdo de documento.

data string  (opcional)

Nenhuma descrição informada.

uri string  (opcional)

Nenhuma descrição informada.

mime_type string  (opcional)

Nenhuma descrição informada.

type string  (obrigatório)

Usado como o discriminador de tipo OpenAPI para o conteúdo oneof.

Sempre defina como "document".

VideoContent

Um bloco de conteúdo em vídeo.

data string  (opcional)

Nenhuma descrição informada.

uri string  (opcional)

Nenhuma descrição informada.

mime_type VideoMimeTypeOption  (opcional)

Nenhuma descrição informada.

Valores possíveis:

  • video/mp4
  • video/mpeg
  • video/mov
  • video/avi
  • video/x-flv
  • video/mpg
  • video/webm
  • video/wmv
  • video/3gpp

O tipo MIME do vídeo.

type string  (obrigatório)

Usado como o discriminador de tipo OpenAPI para o conteúdo oneof.

Sempre defina como "video".

resolution MediaResolution  (opcional)

A resolução da mídia.

Valores possíveis:

  • low
  • medium
  • high

ThoughtContent

Um bloco de conteúdo de pensamento.

signature string  (opcional)

Assinatura para corresponder à origem do back-end que fará parte da geração.

type string  (obrigatório)

Usado como o discriminador de tipo OpenAPI para o conteúdo oneof.

Sempre defina como "thought".

summary ThoughtSummary  (opcional)

Um resumo do pensamento.

Um resumo do pensamento.

FunctionCallContent

Um bloco de conteúdo de chamada de ferramenta de função.

name string  (obrigatório)

O nome da ferramenta a ser chamada.

arguments object  (obrigatório)

Os argumentos a serem transmitidos para a função.

type string  (obrigatório)

Usado como o discriminador de tipo OpenAPI para o conteúdo oneof.

Sempre defina como "function_call".

id string  (obrigatório)

Um ID exclusivo para essa chamada de função específica.

FunctionResultContent

Um bloco de conteúdo de resultado da ferramenta de função.

name string  (opcional)

O nome da ferramenta que foi chamada.

is_error boolean  (opcional)

Se a chamada de função resultou em um erro.

type string  (obrigatório)

Usado como o discriminador de tipo OpenAPI para o conteúdo oneof.

Sempre defina como "function_result".

result objeto ou string  (obrigatório)

O resultado da chamada de função.

call_id string  (obrigatório)

ID para corresponder ao ID do bloco de chamada de função.

CodeExecutionCallContent

Conteúdo de execução de código.

arguments CodeExecutionCallArguments  (opcional)

Os argumentos a serem transmitidos para a execução do código.

Os argumentos a serem transmitidos para a execução do código.

Campos

language enum (string)  (opcional)

Linguagem de programação do "code".

Valores possíveis:

  • python
code string  (opcional)

O código a ser executado.

type string  (obrigatório)

Usado como o discriminador de tipo OpenAPI para o conteúdo oneof.

Sempre defina como "code_execution_call".

id string  (opcional)

Um ID exclusivo para essa chamada de função específica.

CodeExecutionResultContent

Conteúdo do resultado da execução do código.

result string  (opcional)

A saída da execução do código.

is_error boolean  (opcional)

Se a execução do código resultou em um erro.

signature string  (opcional)

Um hash de assinatura para validação de back-end.

type string  (obrigatório)

Usado como o discriminador de tipo OpenAPI para o conteúdo oneof.

Sempre defina como "code_execution_result".

call_id string  (opcional)

ID para corresponder ao ID do bloco de chamada de execução de código.

UrlContextCallContent

Conteúdo do contexto do URL.

arguments UrlContextCallArguments  (opcional)

Os argumentos a serem transmitidos para o contexto do URL.

Os argumentos a serem transmitidos para o contexto do URL.

Campos

urls array (string)  (opcional)

Os URLs a serem buscados.

type string  (obrigatório)

Usado como o discriminador de tipo OpenAPI para o conteúdo oneof.

Sempre defina como "url_context_call".

id string  (opcional)

Um ID exclusivo para essa chamada de função específica.

UrlContextResultContent

Conteúdo do resultado do contexto do URL.

signature string  (opcional)

A assinatura do resultado do contexto do URL.

result UrlContextResult  (opcional)

Os resultados do contexto do URL.

O resultado do contexto do URL.

Campos

url string  (opcional)

O URL buscado.

status enum (string)  (opcional)

O status da recuperação do URL.

Valores possíveis:

  • success
  • error
  • paywall
  • unsafe
is_error boolean  (opcional)

Indica se o contexto do URL resultou em um erro.

type string  (obrigatório)

Usado como o discriminador de tipo OpenAPI para o conteúdo oneof.

Sempre defina como "url_context_result".

call_id string  (opcional)

ID para corresponder ao ID do bloco de chamada de contexto do URL.

GoogleSearchCallContent

Conteúdo da Pesquisa Google.

argumentos GoogleSearchCallArguments  (opcional)

Os argumentos a serem transmitidos para a Pesquisa Google.

Os argumentos a serem transmitidos para a Pesquisa Google.

Campos

queries array (string)  (opcional)

Consultas de pesquisa na Web para a pesquisa na Web de acompanhamento.

type string  (obrigatório)

Usado como o discriminador de tipo OpenAPI para o conteúdo oneof.

Sempre defina como "google_search_call".

id string  (opcional)

Um ID exclusivo para essa chamada de função específica.

GoogleSearchResultContent

Conteúdo dos resultados da Pesquisa Google.

signature string  (opcional)

A assinatura do resultado da Pesquisa Google.

result GoogleSearchResult  (opcional)

Os resultados da Pesquisa Google.

O resultado da Pesquisa Google.

Campos

url string  (opcional)

Referência de URI do resultado da pesquisa.

title string  (opcional)

Título do resultado da pesquisa.

rendered_content string  (opcional)

Snippet de conteúdo da Web que pode ser incorporado a uma página da Web ou a uma WebView de app.

is_error boolean  (opcional)

Se a Pesquisa Google resultou em um erro.

type string  (obrigatório)

Usado como o discriminador de tipo OpenAPI para o conteúdo oneof.

Sempre defina como "google_search_result".

call_id string  (opcional)

ID para corresponder ao ID do bloqueio de chamadas da Pesquisa Google.

McpServerToolCallContent

Conteúdo da chamada de ferramenta MCPServer.

name string  (obrigatório)

O nome da ferramenta que foi chamada.

server_name string  (obrigatório)

O nome do servidor MCP usado.

arguments object  (obrigatório)

O objeto JSON de argumentos para a função.

type string  (obrigatório)

Usado como o discriminador de tipo OpenAPI para o conteúdo oneof.

Sempre defina como "mcp_server_tool_call".

id string  (obrigatório)

Um ID exclusivo para essa chamada de função específica.

McpServerToolResultContent

Conteúdo do resultado da ferramenta MCPServer.

name string  (opcional)

Nome da ferramenta chamada para essa chamada de ferramenta específica.

server_name string  (opcional)

O nome do servidor MCP usado.

type string  (obrigatório)

Usado como o discriminador de tipo OpenAPI para o conteúdo oneof.

Sempre defina como "mcp_server_tool_result".

result objeto ou string  (obrigatório)

O resultado da chamada de função.

call_id string  (obrigatório)

ID para corresponder ao ID do bloco de chamada de ferramenta do servidor MCP.

FileSearchResultContent

Conteúdo dos resultados da Pesquisa de arquivos.

result FileSearchResult  (opcional)

Os resultados da pesquisa de arquivos.

O resultado da pesquisa de arquivos.

Campos

title string  (opcional)

O título do resultado da pesquisa.

text string  (opcional)

O texto do resultado da pesquisa.

file_search_store string  (opcional)

O nome do repositório de pesquisa de arquivos.

type string  (obrigatório)

Usado como o discriminador de tipo OpenAPI para o conteúdo oneof.

Sempre defina como "file_search_result".

Exemplos

Texto

{
  "type": "text",
  "text": "Hello, how are you?"
}

Imagem

{
  "type": "image",
  "data": "BASE64_ENCODED_IMAGE",
  "mime_type": "image/png"
}

Áudio

{
  "type": "audio",
  "data": "BASE64_ENCODED_AUDIO",
  "mime_type": "audio/wav"
}

Documento

{
  "type": "document",
  "data": "BASE64_ENCODED_DOCUMENT",
  "mime_type": "application/pdf"
}

Vídeo

{
  "type": "video",
  "uri": "https://www.youtube.com/watch?v=9hE5-98ZeCg"
}

Raciocínio

{
  "type": "thought",
  "summary": [
    {
      "type": "text",
      "text": "The user is asking about the weather. I should use the get_weather tool."
    }
  ],
  "signature": "CoMDAXLI2nynRYojJIy6B1Jh9os2crpWLfB0+19xcLsGG46bd8wjkF/6RNlRUdvHrXyjsHkG0BZFcuO/bPOyA6Xh5jANNgx82wPHjGExN8A4ZQn56FlMwyZoqFVQz0QyY1lfibFJ2zU3J87uw26OewzcuVX0KEcs+GIsZa3EA6WwqhbsOd3wtZB3Ua2Qf98VAWZTS5y/tWpql7jnU3/CU7pouxQr/Bwft3hwnJNesQ9/dDJTuaQ8Zprh9VRWf1aFFjpIueOjBRrlT3oW6/y/eRl/Gt9BQXCYTqg/38vHFUU4Wo/d9dUpvfCe/a3o97t2Jgxp34oFKcsVb4S5WJrykIkw+14DzVnTpCpbQNFckqvFLuqnJCkL0EQFtunBXI03FJpPu3T1XU6id8S7ojoJQZSauGUCgmaLqUGdMrd08oo81ecoJSLs51Re9N/lISGmjWFPGpqJLoGq6uo4FHz58hmeyXCgHG742BHz2P3MiH1CXHUT2J8mF6zLhf3SR9Qb3lkrobAh"
}

Chamada de função

{
  "type": "function_call",
  "name": "get_weather",
  "id": "gth23981",
  "arguments": {
    "location": "Boston, MA"
  }
}

Resultado da função

{
  "type": "function_result",
  "name": "get_weather",
  "call_id": "gth23981",
  "result": {
    "weather": "sunny"
  }
}

Chamada de execução de código

{
  "type": "code_execution_call",
  "id": "call_123456",
  "arguments": {
    "language": "python",
    "code": "print('hello world')"
  }
}

Resultado da execução do código

{
  "type": "code_execution_result",
  "call_id": "call_123456",
  "result": "hello world\n"
}

Chamada de contexto de URL

{
  "type": "url_context_call",
  "id": "call_123456",
  "arguments": {
    "urls": [
      "https://www.example.com"
    ]
  }
}

Url Context Result

{
  "type": "url_context_result",
  "call_id": "call_123456",
  "result": [
    {
      "url": "https://www.example.com",
      "status": "SUCCESS"
    }
  ]
}

Chamada da Pesquisa Google

{
  "type": "google_search_call",
  "id": "call_123456",
  "arguments": {
    "queries": [
      "weather in Boston"
    ]
  }
}

Resultado da Pesquisa Google

{
  "type": "google_search_result",
  "call_id": "call_123456",
  "result": [
    {
      "url": "https://www.google.com/search?q=weather+in+Boston",
      "title": "Weather in Boston"
    }
  ]
}

Chamada de ferramenta do servidor MCP

{
  "type": "mcp_server_tool_call",
  "id": "call_123456",
  "name": "get_forecast",
  "server_name": "weather_server",
  "arguments": {
    "city": "London"
  }
}

Mcp Server Tool Result

{
  "type": "mcp_server_tool_result",
  "name": "get_forecast",
  "server_name": "weather_server",
  "call_id": "call_123456",
  "result": "sunny"
}

Resultado da pesquisa de arquivos

{
  "type": "file_search_result",
  "result": [
    {
      "text": "search result chunk",
      "file_search_store": "file_search_store"
    }
  ]
}

Ferramenta

Tipos possíveis

Discriminador polimórfico: type

Função

Uma ferramenta que pode ser usada pelo modelo.

name string  (opcional)

O nome da função.

description string  (opcional)

Uma descrição da função.

parameters object  (opcional)

O esquema JSON para os parâmetros da função.

type string  (obrigatório)

Nenhuma descrição informada.

Sempre defina como "function".

GoogleSearch

Uma ferramenta que pode ser usada pelo modelo para pesquisar no Google.

type string  (obrigatório)

Nenhuma descrição informada.

Sempre defina como "google_search".

CodeExecution

Uma ferramenta que pode ser usada pelo modelo para executar código.

type string  (obrigatório)

Nenhuma descrição informada.

Sempre defina como "code_execution".

UrlContext

Uma ferramenta que pode ser usada pelo modelo para buscar o contexto do URL.

type string  (obrigatório)

Nenhuma descrição informada.

Sempre defina como "url_context".

ComputerUse

Uma ferramenta que pode ser usada pelo modelo para interagir com o computador.

type string  (obrigatório)

Nenhuma descrição informada.

Sempre defina como "computer_use".

environment enum (string)  (opcional)

O ambiente em operação.

Valores possíveis:

  • browser
excludedPredefinedFunctions array (string)  (opcional)

A lista de funções predefinidas que são excluídas da chamada de modelo.

McpServer

Um MCPServer é um servidor que pode ser chamado pelo modelo para realizar ações.

type string  (obrigatório)

Nenhuma descrição informada.

Sempre defina como "mcp_server".

name string  (opcional)

O nome do MCPServer.

url string  (opcional)

O URL completo do endpoint MCPServer. Exemplo: "https://api.example.com/mcp"

headers object  (opcional)

Opcional: campos para cabeçalhos de autenticação, tempos limite etc., se necessário.

allowed_tools AllowedTools  (opcional)

As ferramentas permitidas.

A configuração para ferramentas permitidas.

Campos

mode ToolChoiceType  (opcional)

O modo da escolha de ferramenta.

Valores possíveis:

  • auto
  • any
  • none
  • validated

tools array (string)  (opcional)

Os nomes das ferramentas permitidas.

FileSearch

Uma ferramenta que pode ser usada pelo modelo para pesquisar arquivos.

file_search_store_names array (string)  (opcional)

Os nomes das lojas de pesquisa de arquivos a serem pesquisados.

top_k integer  (optional)

O número de partes da recuperação semântica a serem recuperadas.

metadata_filter string  (opcional)

Filtro de metadados a ser aplicado aos documentos e partes da recuperação semântica.

type string  (obrigatório)

Nenhuma descrição informada.

Sempre defina como "file_search".

Exemplos

Função

GoogleSearch

CodeExecution

UrlContext

ComputerUse

McpServer

FileSearch

CANNOT TRANSLATE

Campos

role string  (opcional)

O criador desta rodada. Precisa ser "user" para entrada ou "model" para saída do modelo.

content matriz (Content) ou string  (opcional)

O conteúdo da vez.

Exemplos

Turno do usuário

{
  "role": "user",
  "content": [
    {
      "type": "text",
      "text": "user turn"
    }
  ]
}

Turno do modelo

{
  "role": "model",
  "content": [
    {
      "type": "text",
      "text": "model turn"
    }
  ]
}

InteractionSseEvent

Tipos possíveis

Discriminador polimórfico: event_type

InteractionEvent

event_type enum (string)  (opcional)

Nenhuma descrição informada.

Valores possíveis:

  • interaction.start
  • interaction.complete
interaction Interaction  (opcional)

Nenhuma descrição informada.

event_id string  (opcional)

O token event_id a ser usado para retomar o fluxo de interação, a partir deste evento.

InteractionStatusUpdate

interaction_id string  (opcional)

Nenhuma descrição informada.

status enum (string)  (opcional)

Nenhuma descrição informada.

Valores possíveis:

  • in_progress
  • requires_action
  • completed
  • failed
  • cancelled
event_type string  (opcional)

Nenhuma descrição informada.

Sempre defina como "interaction.status_update".

event_id string  (opcional)

O token event_id a ser usado para retomar o fluxo de interação, a partir deste evento.

ContentStart

index integer  (opcional)

Nenhuma descrição informada.

content Content  (opcional)

Nenhuma descrição informada.

event_type string  (opcional)

Nenhuma descrição informada.

Sempre defina como "content.start".

event_id string  (opcional)

O token event_id a ser usado para retomar o fluxo de interação, a partir deste evento.

ContentDelta

index integer  (opcional)

Nenhuma descrição informada.

event_type string  (opcional)

Nenhuma descrição informada.

Sempre defina como "content.delta".

event_id string  (opcional)

O token event_id a ser usado para retomar o fluxo de interação, a partir deste evento.

delta object  (opcional)

Nenhuma descrição informada.

Tipos possíveis

Discriminador polimórfico: type

TextDelta

text string  (opcional)

Nenhuma descrição informada.

type string  (obrigatório)

Usado como o discriminador de tipo OpenAPI para o conteúdo oneof.

Sempre defina como "text".

annotations Annotation  (opcional)

Informações de citação para conteúdo gerado por modelos.

Informações de citação para conteúdo gerado por modelos.

Campos

start_index integer  (opcional)

Início do segmento da resposta atribuído a esta fonte. O índice indica o início do segmento, medido em bytes.

end_index integer  (opcional)

Fim do segmento atribuído, exclusivo.

source string  (opcional)

Fonte atribuída a uma parte do texto. Pode ser um URL, um título ou outro identificador.

ImageDelta

data string  (opcional)

Nenhuma descrição informada.

uri string  (opcional)

Nenhuma descrição informada.

mime_type ImageMimeTypeOption  (opcional)

Nenhuma descrição informada.

Valores possíveis:

  • image/png
  • image/jpeg
  • image/webp
  • image/heic
  • image/heif

O tipo MIME da imagem.

type string  (obrigatório)

Usado como o discriminador de tipo OpenAPI para o conteúdo oneof.

Sempre defina como "image".

resolution MediaResolution  (opcional)

A resolução da mídia.

Valores possíveis:

  • low
  • medium
  • high

AudioDelta

data string  (opcional)

Nenhuma descrição informada.

uri string  (opcional)

Nenhuma descrição informada.

mime_type AudioMimeTypeOption  (opcional)

Nenhuma descrição informada.

Valores possíveis:

  • audio/wav
  • audio/mp3
  • audio/aiff
  • audio/aac
  • audio/ogg
  • audio/flac

O tipo MIME do áudio.

type string  (obrigatório)

Usado como o discriminador de tipo OpenAPI para o conteúdo oneof.

Sempre defina como "audio".

DocumentDelta

data string  (opcional)

Nenhuma descrição informada.

uri string  (opcional)

Nenhuma descrição informada.

mime_type string  (opcional)

Nenhuma descrição informada.

type string  (obrigatório)

Usado como o discriminador de tipo OpenAPI para o conteúdo oneof.

Sempre defina como "document".

VideoDelta

data string  (opcional)

Nenhuma descrição informada.

uri string  (opcional)

Nenhuma descrição informada.

mime_type VideoMimeTypeOption  (opcional)

Nenhuma descrição informada.

Valores possíveis:

  • video/mp4
  • video/mpeg
  • video/mov
  • video/avi
  • video/x-flv
  • video/mpg
  • video/webm
  • video/wmv
  • video/3gpp

O tipo MIME do vídeo.

type string  (obrigatório)

Usado como o discriminador de tipo OpenAPI para o conteúdo oneof.

Sempre defina como "video".

resolution MediaResolution  (opcional)

A resolução da mídia.

Valores possíveis:

  • low
  • medium
  • high

ThoughtSummaryDelta

type string  (obrigatório)

Usado como o discriminador de tipo OpenAPI para o conteúdo oneof.

Sempre defina como "thought_summary".

content ImageContent ou TextContent  (opcional)

Nenhuma descrição informada.

ThoughtSignatureDelta

signature string  (opcional)

Assinatura para corresponder à origem do back-end que fará parte da geração.

type string  (obrigatório)

Usado como o discriminador de tipo OpenAPI para o conteúdo oneof.

Sempre defina como "thought_signature".

FunctionCallDelta

name string  (opcional)

Nenhuma descrição informada.

arguments object  (opcional)

Nenhuma descrição informada.

type string  (obrigatório)

Usado como o discriminador de tipo OpenAPI para o conteúdo oneof.

Sempre defina como "function_call".

id string  (opcional)

Um ID exclusivo para essa chamada de função específica.

FunctionResultDelta

name string  (opcional)

Nenhuma descrição informada.

is_error boolean  (opcional)

Nenhuma descrição informada.

type string  (obrigatório)

Usado como o discriminador de tipo OpenAPI para o conteúdo oneof.

Sempre defina como "function_result".

result objeto ou string  (opcional)

Delta do resultado da chamada de ferramenta.

call_id string  (opcional)

ID para corresponder ao ID do bloco de chamada de função.

CodeExecutionCallDelta

arguments CodeExecutionCallArguments  (opcional)

Nenhuma descrição informada.

Os argumentos a serem transmitidos para a execução do código.

Campos

language enum (string)  (opcional)

Linguagem de programação do "code".

Valores possíveis:

  • python
code string  (opcional)

O código a ser executado.

type string  (obrigatório)

Usado como o discriminador de tipo OpenAPI para o conteúdo oneof.

Sempre defina como "code_execution_call".

id string  (opcional)

Um ID exclusivo para essa chamada de função específica.

CodeExecutionResultDelta

result string  (opcional)

Nenhuma descrição informada.

is_error boolean  (opcional)

Nenhuma descrição informada.

signature string  (opcional)

Nenhuma descrição informada.

type string  (obrigatório)

Usado como o discriminador de tipo OpenAPI para o conteúdo oneof.

Sempre defina como "code_execution_result".

call_id string  (opcional)

ID para corresponder ao ID do bloco de chamada de função.

UrlContextCallDelta

arguments UrlContextCallArguments  (opcional)

Nenhuma descrição informada.

Os argumentos a serem transmitidos para o contexto do URL.

Campos

urls array (string)  (opcional)

Os URLs a serem buscados.

type string  (obrigatório)

Usado como o discriminador de tipo OpenAPI para o conteúdo oneof.

Sempre defina como "url_context_call".

id string  (opcional)

Um ID exclusivo para essa chamada de função específica.

UrlContextResultDelta

signature string  (opcional)

Nenhuma descrição informada.

result UrlContextResult  (opcional)

Nenhuma descrição informada.

O resultado do contexto do URL.

Campos

url string  (opcional)

O URL buscado.

status enum (string)  (opcional)

O status da recuperação do URL.

Valores possíveis:

  • success
  • error
  • paywall
  • unsafe
is_error boolean  (opcional)

Nenhuma descrição informada.

type string  (obrigatório)

Usado como o discriminador de tipo OpenAPI para o conteúdo oneof.

Sempre defina como "url_context_result".

call_id string  (opcional)

ID para corresponder ao ID do bloco de chamada de função.

GoogleSearchCallDelta

argumentos GoogleSearchCallArguments  (opcional)

Nenhuma descrição informada.

Os argumentos a serem transmitidos para a Pesquisa Google.

Campos

queries array (string)  (opcional)

Consultas de pesquisa na Web para a pesquisa na Web de acompanhamento.

type string  (obrigatório)

Usado como o discriminador de tipo OpenAPI para o conteúdo oneof.

Sempre defina como "google_search_call".

id string  (opcional)

Um ID exclusivo para essa chamada de função específica.

GoogleSearchResultDelta

signature string  (opcional)

Nenhuma descrição informada.

result GoogleSearchResult  (opcional)

Nenhuma descrição informada.

O resultado da Pesquisa Google.

Campos

url string  (opcional)

Referência de URI do resultado da pesquisa.

title string  (opcional)

Título do resultado da pesquisa.

rendered_content string  (opcional)

Snippet de conteúdo da Web que pode ser incorporado a uma página da Web ou a uma WebView de app.

is_error boolean  (opcional)

Nenhuma descrição informada.

type string  (obrigatório)

Usado como o discriminador de tipo OpenAPI para o conteúdo oneof.

Sempre defina como "google_search_result".

call_id string  (opcional)

ID para corresponder ao ID do bloco de chamada de função.

McpServerToolCallDelta

name string  (opcional)

Nenhuma descrição informada.

server_name string  (opcional)

Nenhuma descrição informada.

arguments object  (opcional)

Nenhuma descrição informada.

type string  (obrigatório)

Usado como o discriminador de tipo OpenAPI para o conteúdo oneof.

Sempre defina como "mcp_server_tool_call".

id string  (opcional)

Um ID exclusivo para essa chamada de função específica.

McpServerToolResultDelta

name string  (opcional)

Nenhuma descrição informada.

server_name string  (opcional)

Nenhuma descrição informada.

type string  (obrigatório)

Usado como o discriminador de tipo OpenAPI para o conteúdo oneof.

Sempre defina como "mcp_server_tool_result".

result objeto ou string  (opcional)

Delta do resultado da chamada de ferramenta.

call_id string  (opcional)

ID para corresponder ao ID do bloco de chamada de função.

FileSearchResultDelta

result FileSearchResult  (opcional)

Nenhuma descrição informada.

O resultado da pesquisa de arquivos.

Campos

title string  (opcional)

O título do resultado da pesquisa.

text string  (opcional)

O texto do resultado da pesquisa.

file_search_store string  (opcional)

O nome do repositório de pesquisa de arquivos.

type string  (obrigatório)

Usado como o discriminador de tipo OpenAPI para o conteúdo oneof.

Sempre defina como "file_search_result".

ContentStop

index integer  (opcional)

Nenhuma descrição informada.

event_type string  (opcional)

Nenhuma descrição informada.

Sempre defina como "content.stop".

event_id string  (opcional)

O token event_id a ser usado para retomar o fluxo de interação, a partir deste evento.

ErrorEvent

event_type string  (opcional)

Nenhuma descrição informada.

Sempre defina como "error".

error Error  (opcional)

Nenhuma descrição informada.

Mensagem de erro de uma interação.

Campos

code string  (opcional)

Uma URI que identifica o tipo de erro.

message string  (opcional)

Uma mensagem de erro legível.

event_id string  (opcional)

O token event_id a ser usado para retomar o fluxo de interação, a partir deste evento.

Exemplos

Início da interação

{
  "event_type": "interaction.start",
  "interaction": {
    "id": "v1_ChdTMjQ0YWJ5TUF1TzcxZThQdjRpcnFRcxIXUzI0NGFieU1BdU83MWU4UHY0aXJxUXM",
    "model": "gemini-2.5-flash",
    "object": "interaction",
    "status": "in_progress"
  }
}

Interação concluída

{
  "event_type": "interaction.complete",
  "interaction": {
    "created": "2025-12-09T18:45:40Z",
    "id": "v1_ChdTMjQ0YWJ5TUF1TzcxZThQdjRpcnFRcxIXUzI0NGFieU1BdU83MWU4UHY0aXJxUXM",
    "model": "gemini-2.5-flash",
    "object": "interaction",
    "outputs": [
      {
        "signature": "CoMDAXLI2nynRYojJIy6B1Jh9os2crpWLfB0+19xcLsGG46bd8wjkF/6RNlRUdvHrXyjsHkG0BZFcuO/bPOyA6Xh5jANNgx82wPHjGExN8A4ZQn56FlMwyZoqFVQz0QyY1lfibFJ2zU3J87uw26OewzcuVX0KEcs+GIsZa3EA6WwqhbsOd3wtZB3Ua2Qf98VAWZTS5y/tWpql7jnU3/CU7pouxQr/Bwft3hwnJNesQ9/dDJTuaQ8Zprh9VRWf1aFFjpIueOjBRrlT3oW6/y/eRl/Gt9BQXCYTqg/38vHFUU4Wo/d9dUpvfCe/a3o97t2Jgxp34oFKcsVb4S5WJrykIkw+14DzVnTpCpbQNFckqvFLuqnJCkL0EQFtunBXI03FJpPu3T1XU6id8S7ojoJQZSauGUCgmaLqUGdMrd08oo81ecoJSLs51Re9N/lISGmjWFPGpqJLoGq6uo4FHz58hmeyXCgHG742BHz2P3MiH1CXHUT2J8mF6zLhf3SR9Qb3lkrobAh",
        "type": "thought"
      },
      {
        "text": "Elara\u2019s life was a symphony of quiet moments. A librarian, she found solace in the hushed aisles, the scent of aged paper, and the predictable rhythm of her days. Her small apartment, meticulously ordered, reflected this internal calm, save",
        "type": "text"
      },
      {
        "text": " for one beloved anomaly: a chipped porcelain teacup, inherited from her grandmother, which held her morning Earl Grey.\n\nOne Tuesday, stirring her tea, Elara paused. At the bottom, nestled against the porcelain, was a star.",
        "type": "text"
      },
      {
        "text": " Not a star-shaped tea leaf, but a miniature, perfectly formed celestial body, radiating a faint, cool luminescence. Before she could gasp, it dissolved, leaving only the amber swirl of her brew. She dismissed it as a trick of",
        "type": "text"
      },
      {
        "text": " tired eyes.\n\nBut the next morning, a gossamer-thin feather, smaller than an eyelash and shimmering with iridescent hues, floated on the surface. It vanished the moment she tried to touch it. A week later, a single,",
        "type": "text"
      },
      {
        "text": " impossibly delicate bloom, like spun moonbeam, unfolded in her cup before fading into nothingness.\n\nThese weren't illusions. Each day, Elara\u2019s chipped teacup offered a fleeting, exquisite secret. A tiny, perfect",
        "type": "text"
      },
      {
        "text": " crystal, a miniature spiral nebula, a fragment of rainbow caught in liquid form. They never lingered, never accumulated, simply *were* and then *weren't*, leaving behind a residue of quiet wonder.\n\nElara never spoke",
        "type": "text"
      },
      {
        "text": " of it. It was her private wellspring, a daily reminder that magic could exist in the smallest, most overlooked corners of the world. Her routine remained unchanged, her external life a picture of calm, but inside, a secret garden blo",
        "type": "text"
      },
      {
        "text": "omed. Each dawn brought not just tea, but the silent promise of extraordinary beauty, waiting patiently in a chipped teacup.",
        "type": "text"
      }
    ],
    "role": "model",
    "status": "completed",
    "updated": "2025-12-09T18:45:40Z",
    "usage": {
      "input_tokens_by_modality": [
        {
          "modality": "text",
          "tokens": 11
        }
      ],
      "total_cached_tokens": 0,
      "total_input_tokens": 11,
      "total_output_tokens": 364,
      "total_reasoning_tokens": 1120,
      "total_tokens": 1495,
      "total_tool_use_tokens": 0
    }
  }
}

Atualização do status da interação

{
  "event_type": "interaction.status_update",
  "interaction_id": "v1_ChdTMjQ0YWJ5TUF1TzcxZThQdjRpcnFRcxIXUzI0NGFieU1BdU83MWU4UHY0aXJxUXM",
  "status": "in_progress"
}

Início do conteúdo

{
  "event_type": "content.start",
  "content": {
    "type": "text"
  },
  "index": 1
}

Delta de conteúdo

{
  "event_type": "content.delta",
  "delta": {
    "type": "text",
    "text": "Elara\u2019s life was a symphony of quiet moments. A librarian, she found solace in the hushed aisles, the scent of aged paper, and the predictable rhythm of her days. Her small apartment, meticulously ordered, reflected this internal calm, save"
  },
  "index": 1
}

Parada de conteúdo

{
  "event_type": "content.stop",
  "index": 1
}

Evento de erro

{
  "event_type": "error",
  "error": {
    "message": "Failed to get completed interaction: Result not found.",
    "code": "not_found"
  }
}