Ciclo de Vida do Arquivo
Entenda como o arquivo viaja do seu servidor até o contexto da IA. O processo elimina a necessidade de enviar texto bruto no prompt.
1. Upload
Bucket Temporário
2. Processamento
Extração de Dados
3. Inferência
Uso no Chat
4. Expiração
48 Horas
1. Upload & Armazenamento
O arquivo é transferido para os servidores do Google. Para arquivos grandes (>2GB suportados), utiliza-se o protocolo "Resumable Upload" em duas etapas para garantir estabilidade.
Laboratório de Upload
Simule o protocolo de duas etapas aqui para entender o que seu código backend precisa fazer.
Passo 1: Handshake (POST)
Avisa a API e pede uma URL de upload.
Passo 2: Transferência (PUT)
Envia os bytes brutos para a URL recebida.
Inferência & Chat
Veja a relação entre a UI e o Payload JSON usando o file_uri.
{
"contents": [
{
"role": "user",
"parts": [
{ "file_data": { "mime_type": "application/pdf", "file_uri": "..." } },
{ "text": "" }
]
}
]
}
Referência Técnica
Tipos Suportados
Clique para filtrar.
Todos os Formatos
⚡ Cache de URI
Salve o file_uri no DB. Ele dura 48h.
🚦 Polling
Cheque se state == ACTIVE para arquivos grandes.
🔒 Backend
Nunca exponha sua API Key no frontend.