---
title: "Créer une traduction"
description: "Importez un fichier via l'API et préparez une traduction à planifier, en utilisant du texte JSON, une URL HTTPS ou des données multipart form-data pour les formats binaires."
canonical: "https://ai-glot.com/docs/fr/api/translations/create"
updated: "2026-08-31"
---

# Créer une traduction

Nécessite `batches:create`. Créer une traduction ne coûte rien : les crédits ne sont réservés que lorsque vous [approuvez un plan](/docs/api/translations/approve).

## Choisir le mode d'envoi du fichier

Trois modes de transfert sont disponibles, et le choix dépend du format plutôt que de vos préférences.

| Mode de transfert     | Cas d'usage             | Remarques                                                                                                                |
| --------------------- | ----------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| JSON avec `content`   | Tout format texte       | Le fichier lui-même sous forme de texte UTF-8. La méthode la plus simple pour un agent qui a déjà le contenu en mémoire. |
| JSON avec `file_url`  | Un fichier déjà hébergé | HTTPS uniquement, récupéré côté serveur. Les redirections ne sont pas suivies, vous devez donc fournir l'URL finale.     |
| `multipart/form-data` | XLSX et ZIP             | **Obligatoire** pour les formats binaires : ils ne peuvent pas être transmis sous forme de texte JSON.                   |

`filename` est facultatif mais utile. L'extension permet d'identifier le format : ainsi, un nom comme `strings.xml` et un nom comme `export.csv` mèneront à des parseurs différents sur des octets identiques.

## Ce qui se passe ensuite

La réponse renvoie un `batch_id`. À partir de là, la séquence est toujours la même :

1. [`POST /v1/batches/{batch_id}/plan`](/docs/api/translations/plan) : décrivez ce qu'il faut traduire, avec vos propres mots.
2. [`POST /v1/batches/{batch_id}/approve`](/docs/api/translations/approve) : débitez les crédits et lancez le traitement.
3. [`GET /v1/batches/{batch_id}`](/docs/api/translations/retrieve) : interrogez l'endpoint jusqu'à la fin du traitement.
4. [`GET /v1/batches/{batch_id}/result`](/docs/api/translations/download) : récupérez le résultat. Un lien signé est renvoyé, et non le fichier directement.

> **Info: Les limites de taille dépendent du format**
>
> Chaque famille de formats a son propre plafond, de 4 Mo à 60 Mo. Consultez [Fichiers et formats](/docs/platform/files-and-formats) pour le tableau complet. Tout fichier dépassant sa limite est refusé avec l'erreur `file_too_large` avant le moindre stockage d'octets.