batches

Lister les traductions

Les plus récentes apparaissent en premier, les archivées sont exclues par défaut. La pagination est basée sur un curseur: transmettez le next_cursor de la réponse précédente tel quel. Les offsets ne sont pas supportés car une traduction créée pendant la pagination décalerait silencieusement les résultats. search correspond au nom d'une traduction ou, en l'absence de nom, au nom du fichier téléchargé: c'est la même recherche que celle utilisée par la liste des lots de l'application web, les résultats ne divergent donc jamais entre les deux.

GET/v1/batches

Request

curl --request GET \
  --url 'https://api.ai-glot.com/v1/batches' \
  --header 'Authorization: <api-key>'

<?php
$client = curl_init();

curl_setopt($client, CURLOPT_URL, "https://api.ai-glot.com/v1/batches");
curl_setopt($client, CURLOPT_CUSTOMREQUEST, "GET");
curl_setopt($client, CURLOPT_HTTPHEADER, [
    "Authorization: <api-key>",
]);
curl_setopt($client, CURLOPT_RETURNTRANSFER, true);

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

package main

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

func main() {
  req, _ := http.NewRequest("GET", "https://api.ai-glot.com/v1/batches", nil)
  req.Header.Set("Authorization", "<api-key>")
  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>")
    .method("GET", HttpRequest.BodyPublishers.noBody())
    .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::Get.new(uri)
request["Authorization"] = "<api-key>"

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": {},
        "will_translate": {},
        "will_not_touch": {},
        "special_rules": [
          {}
        ],
        "assumptions": [
          {}
        ],
        "not_included": [
          {}
        ],
        "languages": [
          {}
        ],
        "totals": {
          "segments": {},
          "words": {},
          "files": {}
        },
        "credits": {
          "standard": {},
          "lite": {}
        },
        "preview": [
          {}
        ],
        "cached": true
      },
      "suggested_instructions": [
        "<string>"
      ]
    }
  ],
  "has_more": true,
  "next_cursor": null,
  "limit": 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:read. Les traductions archivées sont exclues par défaut. Renvoyez next_cursor tel quel pour récupérer la page suivante.

Filtrez avec status, archived, quality_tier, created_after et created_before. search correspond au nom d’une traduction ou, à défaut, au nom du fichier importé. Il s’agit de la même recherche que celle utilisée par la liste de l’application web, les deux sont donc toujours synchronisées.

Cet endpoint est uniquement en lecture : il ne lance pas de traduction et ne consomme aucun crédit. Il liste chaque traduction de l’espace de travail, quelle que soit l’interface qui l’a créée. Pour en lancer une, créez une traduction.

Réponse

application/json

Lister les traductions

dataobject[]required

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

has_morebooleanrequired

next_cursorstringnullrequired

limitintegerrequired

request_idstringrequired

Lister les traductions

Réponse

Use these docs with your AI tools

Query these docs via MCP

Query these docs over HTTP

Read these docs as Markdown