---
title: "Envoyer les octets du fichier"
description: "Envoyez les octets bruts du fichier d’origine à une URL d’envoi temporaire à l’aide de son secret réservé à l’envoi, puis récupérez le fichier en toute sécurité si la requête est interrompue."
canonical: "https://ai-glot.com/docs/fr/api/uploads/send"
updated: "2026-10-02"
---

# Envoyer les octets du fichier

Utilisez `upload_url`, `method` et `headers` renvoyés lors de la [création d’une session d’envoi](/docs/api/uploads/create). Cet endpoint nécessite l’en-tête temporaire `Authorization`, réservé à l’envoi. Une clé API d’espace de travail ou un jeton d’accès OAuth ne peut pas autoriser cette requête.

Envoyez le fichier lui-même dans le corps HTTP avec `Content-Type: application/octet-stream`. Ne l’enveloppez pas dans du JSON, du base64 ou du multipart. Si `Content-Length` est fourni, sa valeur doit être égale à `size_bytes` de la session. Les requêtes sans cet en-tête restent limitées à la taille attendue. Les corps HTTP compressés sont refusés ; envoyez les octets du document d’origine.

Une réponse positive contient `upload_id`, `uploaded: true` et `size_bytes`. Poursuivez en transmettant `upload_id` pour [créer une traduction](/docs/api/translations/create) avec le même identifiant d’accès à l’espace de travail que celui utilisé pour créer la session. Seule l’approbation lance la traduction et dépense des crédits.

## Reprendre en toute sécurité

Une session autorise une seule tentative PUT. Les requêtes simultanées et les PUT répétés ne peuvent pas remplacer son fichier. Une tentative échouée ou interrompue nécessite une nouvelle session.

Si la réponse à l’envoi a été perdue, essayez d’abord de créer la traduction avec l’`upload_id` existant. Un envoi complet est conservé même si le client n’a pas reçu la réponse de confirmation. Si aucun envoi complet n’existe, demandez une nouvelle session et renvoyez le fichier. Ne renvoyez jamais les octets pour écraser l’ancienne session. La récupération par upload\_id est possible jusqu’au nettoyage de la session, au moins 24 heures après son émission. Conservez l’ID de lot pour retrouver ensuite la traduction dans votre historique.

Un envoi expiré renvoie `file_expired`. Un PUT effectué après utilisation de l’autorisation renvoie `batch_not_editable`. Une autre connexion ou un autre espace de travail ne peut pas utiliser l’envoi. Des octets incomplets ou une taille incorrecte renvoient `invalid_parameter` ; un nombre d’octets supérieur à la taille de la session renvoie `file_too_large`.

Cet endpoint binaire est appelé par un client HTTP externe, et non par un outil MCP ou un script AI Glot Code Mode. Si votre assistant ne peut pas accéder au fichier d’origine ou effectuer une requête PUT, informez-en l’utilisateur et proposez-lui l’application Web, la CLI ou un lien de téléchargement HTTPS. Ne divulguez jamais le secret temporaire dans votre explication.
