batches

Approuver le plan et traduire

Spends credits: the plan's measured word count at the chosen quality (standard: 1 word = 1 credit; lite: a third, rounded up) is reserved and settled at completion. Returns the initial progress with estimated_seconds_remaining — poll the translation with GET from here.

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>"
}'

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>\"}")

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>"
  }),
});

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>\"}");
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>\"}")))
  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>\"}"))
    .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>\"}"

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.

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>" }'

{ "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

Use these docs with your AI tools

Query these docs via MCP

Query these docs over HTTP

Read these docs as Markdown