---
title: "Crea una traduzione"
description: "Carica un file tramite API e ottieni una traduzione pronta da pianificare, usando testo JSON, un URL HTTPS o multipart/form-data per i formati binari."
canonical: "https://ai-glot.com/docs/it/api/translations/create"
updated: "2026-08-31"
---

# Crea una traduzione

Richiede `batches:create`. Creare una traduzione non costa nulla: i crediti vengono riservati solo quando [approvi un piano](/docs/api/translations/approve).

## Scegliere come inviare il file

Sono disponibili tre metodi di invio, e la scelta corretta dipende dal formato e non dalle preferenze.

| Metodo di invio       | Utilizzo                   | Note                                                                                                         |
| --------------------- | -------------------------- | ------------------------------------------------------------------------------------------------------------ |
| JSON con `content`    | Qualsiasi formato di testo | Il file stesso come testo UTF-8. La soluzione più semplice per un agente che ha già il contenuto in memoria. |
| JSON con `file_url`   | Un file già ospitato       | Solo HTTPS, recuperato lato server. I reindirizzamenti non vengono seguiti, quindi fornisci l'URL finale.    |
| `multipart/form-data` | XLSX e ZIP                 | **Obbligatorio** per i formati binari: non possono essere inviati come testo JSON.                           |

`filename` è facoltativo ma consigliato. L'estensione determina l'identificazione del formato, quindi un nome come `strings.xml` e uno come `export.csv` faranno intervenire parser diversi su byte identici.

## Cosa succede dopo

La risposta restituisce un `batch_id`. Da qui la sequenza è sempre la stessa:

1. [`POST /v1/batches/{batch_id}/plan`](/docs/api/translations/plan): descrivi cosa tradurre, con parole tue.
2. [`POST /v1/batches/{batch_id}/approve`](/docs/api/translations/approve): scala i crediti e avvia la traduzione.
3. [`GET /v1/batches/{batch_id}`](/docs/api/translations/retrieve): effettua il polling fino al completamento.
4. [`GET /v1/batches/{batch_id}/result`](/docs/api/translations/download): recupera il risultato. Restituisce un link firmato, non il file vero e proprio.

> **Info: I limiti di dimensione dipendono dal formato**
>
> Ogni famiglia di formati ha un limite dedicato, da 4 MB a 60 MB. Consulta [File e formati](/docs/platform/files-and-formats) per la tabella completa. I file che superano il limite vengono rifiutati con `file_too_large` prima che venga memorizzato qualsiasi byte.