batches

Préparer ou affiner le plan

Échanges en langage naturel. Envoyez instruction pour (re)planifier depuis le début, ou refinement pour ajuster le plan actuel ("en fait, seulement les lignes vides"). La réponse intègre le plan reconstruit avec les comptages mesurés et un aperçu de 10 extractions réelles. Rien n'est facturé avant l'approbation; vérifiez plan.not_included: une liste non vide signifie qu'une partie de l'instruction ne sera PAS exécutée.

POST/v1/batches/{batch_id}/plan

Request

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

import json
import requests

url = "https://api.ai-glot.com/v1/batches/<batch_id>/plan"
headers = {
  "Authorization": "<api-key>",
  "Content-Type": "application/json"
}
payload = json.loads("{\"instruction\":\"<string>\",\"refinement\":\"<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>/plan", {
  method: "POST",
  headers: {
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "instruction": "<string>",
    "refinement": "<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>/plan");
curl_setopt($client, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($client, CURLOPT_HTTPHEADER, [
    "Authorization: <api-key>",
    "Content-Type: application/json",
]);
curl_setopt($client, CURLOPT_POSTFIELDS, "{\"instruction\":\"<string>\",\"refinement\":\"<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>/plan", bytes.NewBuffer([]byte("{\"instruction\":\"<string>\",\"refinement\":\"<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>/plan"))
    .header("Authorization", "<api-key>")
    .header("Content-Type", "application/json")
    .method("POST", HttpRequest.BodyPublishers.ofString("{\"instruction\":\"<string>\",\"refinement\":\"<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>/plan")
request = Net::HTTP::Post.new(uri)
request["Authorization"] = "<api-key>"
request["Content-Type"] = "application/json"
request.body = "{\"instruction\":\"<string>\",\"refinement\":\"<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. La planification est gratuite et réitérable : aucun crédit n’est débité tant que vous n’avez pas approuvé.

Instruction ou ajustement

Envoyez l’un ou l’autre, mais pas les deux.

Champ	Signification
`instruction`	Planifier à partir de zéro. Remplace entièrement tout plan précédent.
`refinement`	Ajuster le plan existant : « en fait, uniquement les lignes vides », « ne pas toucher aux URL ».

La distinction a son importance lorsqu’un plan est presque parfait : refinement conserve tout ce que vous avez déjà validé, tandis qu’instruction repart de zéro et risque de réinterpréter des éléments qui vous convenaient.

Examiner le plan avant d’approuver

La réponse intègre le plan recalculé avec des métriques mesurées (le nombre réel d’éléments et de mots trouvés dans votre fichier, et non une estimation basée sur sa taille), ainsi qu’un aperçu de dix extractions réelles.

Ces dix extractions constituent la vérification la plus économique qui soit. Elles affichent exactement les chaînes qui seront envoyées pour traduction : une instruction qui ciblait discrètement le mauvais champ est ainsi repérable avant d’engager le moindre coût.

Réponse

application/json

Préparer ou affiner le plan de traduction

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

Préparer ou affiner le plan

Instruction ou ajustement

Examiner le plan avant d’approuver

Réponse

Use these docs with your AI tools

Query these docs via MCP

Query these docs over HTTP

Read these docs as Markdown