batches

Créer une traduction

Envoyez le fichier de trois manières: JSON avec content (le fichier lui-même en texte UTF-8, formats texte uniquement, le chemin le plus simple pour les agents), JSON avec file_url (HTTPS, récupéré côté serveur, sans redirections), ou multipart/form-data avec un champ file (requis pour XLSX et ZIP). filename est optionnel: s'il est omis, un nom par défaut est généré et le format est déduit automatiquement du contenu. Incluez instruction pour obtenir le plan complet et validé dans la même réponse (prend quelques secondes); omettez-le pour recevoir quatre suggested_instructions basées sur le contexte et continuez avec le point de terminaison plan. La qualité est choisie lors de l'approbation, pas ici: le plan chiffre les deux tiers. Les limites de taille par format sont disponibles sur /v1/account sous entitlements.max_upload_bytes_by_format. Le téléchargement apparaît également dans l'application web.

POST/v1/batches

Request

curl --request POST \
  --url 'https://api.ai-glot.com/v1/batches' \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "file_url": "<string>",
  "content": "<string>",
  "filename": "<string>",
  "instruction": "<string>"
}'

import json
import requests

url = "https://api.ai-glot.com/v1/batches"
headers = {
  "Authorization": "<api-key>",
  "Content-Type": "application/json"
}
payload = json.loads("{\"file_url\":\"<string>\",\"content\":\"<string>\",\"filename\":\"<string>\",\"instruction\":\"<string>\"}")

response = requests.request("POST", url, headers=headers, json=payload)
print(response.json())

const response = await fetch("https://api.ai-glot.com/v1/batches", {
  method: "POST",
  headers: {
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "file_url": "<string>",
    "content": "<string>",
    "filename": "<string>",
    "instruction": "<string>"
  }),
});

const data = await response.json();
console.log(data);

<?php
$client = curl_init();

curl_setopt($client, CURLOPT_URL, "https://api.ai-glot.com/v1/batches");
curl_setopt($client, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($client, CURLOPT_HTTPHEADER, [
    "Authorization: <api-key>",
    "Content-Type: application/json",
]);
curl_setopt($client, CURLOPT_POSTFIELDS, "{\"file_url\":\"<string>\",\"content\":\"<string>\",\"filename\":\"<string>\",\"instruction\":\"<string>\"}");
curl_setopt($client, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($client);
curl_close($client);
echo $response;

package main

import (
  "bytes"
  "fmt"
  "io"
  "net/http"
)

func main() {
  req, _ := http.NewRequest("POST", "https://api.ai-glot.com/v1/batches", bytes.NewBuffer([]byte("{\"file_url\":\"<string>\",\"content\":\"<string>\",\"filename\":\"<string>\",\"instruction\":\"<string>\"}")))
  req.Header.Set("Authorization", "<api-key>")
  req.Header.Set("Content-Type", "application/json")
  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  data, _ := io.ReadAll(res.Body)
  fmt.Println(string(data))
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

var request = HttpRequest.newBuilder(URI.create("https://api.ai-glot.com/v1/batches"))
    .header("Authorization", "<api-key>")
    .header("Content-Type", "application/json")
    .method("POST", HttpRequest.BodyPublishers.ofString("{\"file_url\":\"<string>\",\"content\":\"<string>\",\"filename\":\"<string>\",\"instruction\":\"<string>\"}"))
    .build();

var response = HttpClient.newHttpClient().send(
    request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

require 'net/http'
require 'json'

uri = URI("https://api.ai-glot.com/v1/batches")
request = Net::HTTP::Post.new(uri)
request["Authorization"] = "<api-key>"
request["Content-Type"] = "application/json"
request.body = "{\"file_url\":\"<string>\",\"content\":\"<string>\",\"filename\":\"<string>\",\"instruction\":\"<string>\"}"

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == "https") do |http|
  http.request(request)
end

puts response.body

application/json

{
  "data": {
    "id": "<string>",
    "name": "<string>",
    "file_name": "<string>",
    "status": "analyzing",
    "quality_tier": "<string>",
    "word_count": 123,
    "credit_cost": 123,
    "is_sample": true,
    "archived": true,
    "progress": {
      "phase": "<string>",
      "percent": 123.45,
      "updated_at": "<string>",
      "estimated_seconds_remaining": 123
    },
    "error": {
      "code": "<string>",
      "message": "<string>"
    },
    "created_at": "<string>",
    "completed_at": "<string>",
    "next_action": "provide_instruction",
    "plan": {
      "instruction": "<string>",
      "summary": "<string>",
      "will_translate": "<string>",
      "will_not_touch": "<string>",
      "special_rules": [
        "<string>"
      ],
      "assumptions": [
        "<string>"
      ],
      "not_included": [
        "<string>"
      ],
      "languages": [
        {
          "source": {},
          "target": {},
          "segments": {},
          "words": {}
        }
      ],
      "totals": {
        "segments": 123,
        "words": 123,
        "files": {}
      },
      "credits": {
        "standard": 123,
        "lite": 123
      },
      "preview": [
        {
          "location": {},
          "source_text": {},
          "source_lang": {},
          "target_lang": {}
        }
      ],
      "cached": true
    },
    "suggested_instructions": [
      "<string>"
    ]
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>"
  },
  "request_id": "<string>"
}

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.

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 :

POST /v1/batches/{batch_id}/plan : décrivez ce qu’il faut traduire, avec vos propres mots.
POST /v1/batches/{batch_id}/approve : débitez les crédits et lancez le traitement.
GET /v1/batches/{batch_id} : interrogez l’endpoint jusqu’à la fin du traitement.
GET /v1/batches/{batch_id}/result : récupérez le résultat. Un lien signé est renvoyé, et non le fichier directement.

Réponse

application/json

Créer une traduction à partir d'un fichier

dataobjectrequired

Show child attributes

idstringrequired

namestring | nullrequired

file_namestring | nullrequired

statusstringrequired

État de la traduction. Les sept valeurs possibles: analyzing: la structure du fichier est lue, cela prend quelques secondes: effectuez un poll. awaiting_instructions: le fichier est lu, mais personne n'a indiqué quoi traduire: appelez plan. awaiting_approval: un plan attend une validation: appelez approve, le seul appel qui consomme des crédits. translating: exécution en cours: effectuez un poll. completed: récupérez le résultat. failed: l'exécution n'a pas pu se terminer: lisez error. cancelled: quelqu'un l'a arrêtée volontairement: état également terminal, et non un échec. Les trois derniers sont terminaux: arrêtez le polling.

quality_tierstring | nullrequired

word_countinteger | nullrequired

credit_costinteger | nullrequired

is_samplebooleanrequired

archivedbooleanrequired

progressobjectrequired

errorobject | nullrequired

created_atstring | nullrequired

completed_atstring | nullrequired

next_actionstring

L'appel à effectuer ensuite, pour qu'un client n'ait jamais à mapper status lui-même. provide_instruction: appelez plan avec une instruction. review_plan: le plan chiffré est intégré: vérifiez plan.not_included, puis approuvez. wait: effectuez un nouveau poll: progress.estimated_seconds_remaining indique le temps restant. download: récupérez le résultat. read_error: l'exécution est terminée sans résultat: lisez error (et status indique s'il y a eu une erreur ou une annulation). Absent uniquement pour un lot CSV hérité antérieur au 2026-08-31, qui ne possède pas de plan: toute traduction créée depuis lors répond.

planobject | null

suggested_instructionsstring[] | null

request_idstringrequired

Créer une traduction

Choisir le mode d’envoi du fichier

Ce qui se passe ensuite

Réponse

Use these docs with your AI tools

Query these docs via MCP

Query these docs over HTTP

Read these docs as Markdown