---
title: "Enviar bytes do arquivo"
description: "Envie os bytes brutos originais do arquivo para uma URL temporária de upload usando o segredo exclusivo para upload e, em seguida, recupere-se com segurança de solicitações interrompidas."
canonical: "https://ai-glot.com/docs/pt/api/uploads/send"
updated: "2026-10-02"
---

# Enviar bytes do arquivo

Use `upload_url`, `method` e `headers` retornados ao [criar uma sessão de upload](/docs/api/uploads/create). Este endpoint requer o cabeçalho temporário `Authorization`, exclusivo para upload. Uma chave de API do workspace ou um token de acesso OAuth não autorizam esta solicitação.

Envie o próprio arquivo no corpo HTTP, com `Content-Type: application/octet-stream`. Não o envolva em JSON, base64 nem multipart. Se informado, `Content-Length` precisa corresponder a `size_bytes` da sessão. Solicitações sem esse cabeçalho também estão limitadas ao tamanho esperado. Corpos HTTP compactados são recusados. Envie os bytes originais do documento.

Uma resposta de sucesso contém `upload_id`, `uploaded: true` e `size_bytes`. Em seguida, envie `upload_id` para [criar uma tradução](/docs/api/translations/create), usando a mesma credencial do workspace que criou a sessão. A tradução só começa e consome créditos quando o plano é aprovado.

## Como se recuperar com segurança

Cada sessão permite uma única tentativa de PUT. Solicitações simultâneas ou PUTs repetidos não podem substituir o arquivo. Se a tentativa falhar ou for interrompida, será necessária uma nova sessão.

Se a resposta do upload se perdeu, tente primeiro criar a tradução com o `upload_id` existente. Um upload completo é mantido mesmo que o cliente não tenha recebido a resposta de sucesso. Se não houver um upload completo, solicite uma nova sessão e envie o arquivo novamente. Nunca reenvie bytes para sobrescrever a sessão antiga. A recuperação por upload\_id fica disponível até a limpeza da sessão, no mínimo 24 horas após a emissão. Guarde o ID do lote para recuperar a tradução do seu histórico depois.

Um upload expirado retorna `file_expired`. Um PUT após o uso da capacidade retorna `batch_not_editable`. Outra conexão ou workspace não pode usar o upload. Bytes incompletos ou tamanho incorreto retornam `invalid_parameter`. Bytes que excedam o tamanho da sessão retornam `file_too_large`.

Este endpoint binário é chamado por um cliente HTTP externo, não por uma ferramenta MCP nem por um script do AI Glot Code Mode. Se o assistente não conseguir acessar o arquivo original ou fazer uma solicitação PUT, informe o usuário e ofereça o app web, a CLI ou um link de download HTTPS. Nunca revele o segredo temporário na sua explicação.