Crea una sessione di caricamento

Richiede batches:create. Creare una sessione non costa crediti e non crea una traduzione. Invia un nome file semplice, con un’estensione supportata, e la dimensione esatta dei byte originali:

{ "filename": "catalogue.xlsx", "size_bytes": 4096 }

La risposta contiene upload_id, upload_url, method, headers, expires_at, consume_until e instructions in forma leggibile. Usa l’URL e le intestazioni ricevuti esattamente come sono con un client HTTP esterno, quindi crea la traduzione specificando upload_id e usando le stesse credenziali. Il nome file è già associato alla sessione.

const session = createUploadResponse.data;
const uploaded = await fetch(session.upload_url, {
  method: session.method,
  headers: session.headers,
  body: originalFileBytes,
  redirect: "error",
});
if (!uploaded.ok) throw new Error(`Upload failed: ${uploaded.status}`);
// Use the original workspace credential for POST /v1/batches:
// { upload_id: session.upload_id, instruction: "Translate into French" }

L’intestazione temporanea Authorization consente un solo tentativo di caricamento per questo documento nell’arco di 10 minuti. Il solo URL non concede alcun accesso. Non sostituire mai questa intestazione con una chiave API dello spazio di lavoro o un token OAuth, non inserire segreti in un URL, non seguire reindirizzamenti e non registrare le intestazioni temporanee. Il segreto di caricamento non può leggere documenti, creare traduzioni né approvare spese. Revocando la connessione o rimuovendo la relativa autorizzazione, le funzionalità di caricamento non ancora utilizzate vengono invalidate.

Il numero di byte ricevuti deve corrispondere a size_bytes; il limite per formato viene verificato prima di rilasciare la capability. Crea la traduzione entro un’ora. Un workspace può avere 20 caricamenti in sospeso e creare 120 sessioni all’ora. I file non utilizzati possono essere eliminati dopo 24 ore e vengono rimossi durante la pulizia giornaliera. Una volta associato a una traduzione, al file si applicano i normali tempi di conservazione. 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.

Requisiti per gli agenti

L’ambiente di esecuzione dell’agente deve poter accedere ai file locali e disporre di un client HTTP in grado di inviare richieste PUT con byte non elaborati. MCP da solo non può inviare dati binari e AI Glot Code Mode non può accedere ai file locali né effettuare richieste HTTP in uscita. Se queste funzionalità non sono disponibili, comunica chiaramente all’utente che l’assistente non può inviare l’allegato. Suggerisci di caricarlo nell’app web di AI Glot, di usare la CLI oppure di fornire un link di download HTTPS da usare con file_url. Non dichiarare mai che il caricamento è riuscito senza averlo verificato.

Dopo il caricamento, esamina il piano di traduzione e le relative esclusioni prima di approvare il costo in crediti. Inviare byte non elaborati descrive i tentativi successivi e gli errori.