---
title: "Invia i byte del file"
description: "Invia i byte originali del file a un URL di caricamento temporaneo usando il relativo segreto valido solo per il caricamento, poi recupera in sicurezza le richieste interrotte."
canonical: "https://ai-glot.com/docs/it/api/uploads/send"
updated: "2026-10-02"
---

# Invia i byte del file

Usa `upload_url`, `method` e `headers` restituiti da [creare una sessione di caricamento](/docs/api/uploads/create). Questo endpoint richiede l'intestazione temporanea `Authorization`, valida solo per il caricamento. Una chiave API dello spazio di lavoro o un token di accesso OAuth non autorizzano questa richiesta.

Invia il file stesso nel corpo HTTP con `Content-Type: application/octet-stream`. Non inserirlo in JSON, codificarlo in base64 né inviarlo come multipart. Se specificato, `Content-Length` deve corrispondere a `size_bytes` della sessione. Anche le richieste prive di questa intestazione sono limitate alla dimensione prevista. I corpi HTTP compressi vengono rifiutati: invia i byte originali del documento.

Una risposta positiva contiene `upload_id`, `uploaded: true` e `size_bytes`. Per continuare, invia `upload_id` per [creare una traduzione](/docs/api/translations/create), usando le stesse credenziali dello spazio di lavoro con cui hai creato la sessione. La traduzione parte e consuma crediti solo dopo l'approvazione.

## Recupero sicuro

Ogni sessione consente un solo tentativo PUT. Le richieste simultanee o le richieste PUT ripetute non possono sostituire il file. Se il tentativo fallisce o viene interrotto, serve una nuova sessione.

Se hai perso la risposta al caricamento, prova prima a creare la traduzione con l’`upload_id` esistente. Un caricamento completo viene conservato anche se il client non ha ricevuto la risposta di conferma. Se non esiste un caricamento completo, richiedi una nuova sessione e invia di nuovo il file. Non inviare mai di nuovo i byte per sovrascrivere la vecchia sessione. Il recupero tramite upload\_id è disponibile fino alla pulizia della sessione, che avviene almeno 24 ore dopo l’emissione. Conserva l’ID batch per recuperare in seguito la traduzione dalla cronologia.

Un caricamento scaduto restituisce `file_expired`. Una richiesta PUT dopo che la funzionalità è stata usata restituisce `batch_not_editable`. Una connessione o uno spazio di lavoro diversi non possono usare il caricamento. Byte incompleti o una dimensione non corretta restituiscono `invalid_parameter`; i byte che superano la dimensione prevista dalla sessione restituiscono `file_too_large`.

Questo endpoint binario viene chiamato da un client HTTP esterno, non da uno strumento MCP né da uno script AI Glot Code Mode. Se l'assistente non può accedere al file originale o inviare una richiesta PUT, comunicalo all'utente e proponi l'app web, la CLI o un link di download HTTPS. Non rivelare il segreto temporaneo nella spiegazione.