batches

Approuver le plan et traduire

Consomme des crédits : le nombre de mots mesuré dans le plan, selon la qualité choisie (standard : 1 mot = 1 crédit ; lite : un tiers de crédit, arrondi à l’entier supérieur), est réservé puis débité à la fin. Transmettez expected_plan_revision (le plan_revision du lot) pour approuver exactement le plan examiné : l’appel est refusé avec plan_changed si le plan a été recréé depuis. Ce paramètre est facultatif ici pour assurer la compatibilité avec les scripts existants, et obligatoire dans MCP et Code Mode, où un modèle prend la décision. Renvoie la progression initiale avec estimated_seconds_remaining ; interrogez ensuite la traduction avec GET.

POST/v1/batches/{batch_id}/approve

Request

curl --request POST \
  --url 'https://api.ai-glot.com/v1/batches/<batch_id>/approve' \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "quality": "standard",
  "custom_instructions": "<string>",
  "expected_plan_revision": "<string>"
}'

import json
import requests

url = "https://api.ai-glot.com/v1/batches/<batch_id>/approve"
headers = {
  "Authorization": "<api-key>",
  "Content-Type": "application/json"
}
payload = json.loads("{\"quality\":\"standard\",\"custom_instructions\":\"<string>\",\"expected_plan_revision\":\"<string>\"}")

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

const response = await fetch("https://api.ai-glot.com/v1/batches/<batch_id>/approve", {
  method: "POST",
  headers: {
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "quality": "standard",
    "custom_instructions": "<string>",
    "expected_plan_revision": "<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/<batch_id>/approve");
curl_setopt($client, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($client, CURLOPT_HTTPHEADER, [
    "Authorization: <api-key>",
    "Content-Type: application/json",
]);
curl_setopt($client, CURLOPT_POSTFIELDS, "{\"quality\":\"standard\",\"custom_instructions\":\"<string>\",\"expected_plan_revision\":\"<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/<batch_id>/approve", bytes.NewBuffer([]byte("{\"quality\":\"standard\",\"custom_instructions\":\"<string>\",\"expected_plan_revision\":\"<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/<batch_id>/approve"))
    .header("Authorization", "<api-key>")
    .header("Content-Type", "application/json")
    .method("POST", HttpRequest.BodyPublishers.ofString("{\"quality\":\"standard\",\"custom_instructions\":\"<string>\",\"expected_plan_revision\":\"<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/<batch_id>/approve")
request = Net::HTTP::Post.new(uri)
request["Authorization"] = "<api-key>"
request["Content-Type"] = "application/json"
request.body = "{\"quality\":\"standard\",\"custom_instructions\":\"<string>\",\"expected_plan_revision\":\"<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>",
    "status": "<string>",
    "credits_charged": 123,
    "word_count": 123,
    "progress": {
      "percent": 123.45,
      "estimated_seconds_remaining": 123
    }
  },
  "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. Cet appel déclenche la dépense de crédits. Toutes les étapes préalables (création, planification, affinement) sont gratuites.

Combien cela coûte-t-il ?

Le nombre de mots mesuré dans le plan est réservé selon le niveau de qualité choisi, puis régularisé en fonction de la consommation réelle une fois la traduction terminée.

Qualité	Coût	Disponibilité
`standard`	1 crédit par mot	Tous les forfaits
`lite`	Un tiers des mots, arrondi à l’unité supérieure	Forfaits payants

Comme le décompte est directement mesuré à partir du fichier et non estimé, le montant réservé correspond exactement au chiffre indiqué dans la réponse du plan. Si le solde est insuffisant, l’appel échoue avec l’erreur insufficient_credits et aucun crédit n’est réservé.

Suivre ensuite l’avancement

La réponse renvoie l’état initial de progression, notamment estimated_seconds_remaining. À partir de là, interrogez régulièrement GET /v1/batches/{batch_id} plutôt que de réappeler l’approbation. Une seconde approbation sur une traduction en cours échoue avec l’erreur batch_not_awaiting_approval.

Le champ custom_instructions applique des consignes spécifiques à ce lot uniquement, en complément des glossaires éventuels de l’espace de travail. Il ne modifie pas le plan : il n’a donc aucun impact sur les éléments traduits, mais uniquement sur la manière de les traduire.

Réponse

application/json

Approuver le plan et lancer la traduction

dataobjectrequired

Show child attributes

idstringrequired

statusstringrequired

credits_chargedintegerrequired

word_countintegerrequired

progressobjectrequired

request_idstringrequired

curl --request POST \ --url 'https://api.ai-glot.com/v1/batches/<batch_id>/approve' \ --header 'Authorization: <api-key>' \ --header 'Content-Type: application/json' \ --data '{ "quality": "standard", "custom_instructions": "<string>", "expected_plan_revision": "<string>" }'

{ "data": { "id": "<string>", "status": "<string>", "credits_charged": 123, "word_count": 123, "progress": { "percent": 123.45, "estimated_seconds_remaining": 123 } }, "request_id": "<string>" }

Approuver le plan et traduire

Combien cela coûte-t-il ?

Suivre ensuite l’avancement

Réponse

Use these docs with your AI tools

Query these docs via MCP

Query these docs over HTTP

Read these docs as Markdown