batches

Preparar ou ajustar o plano

Natural-language back and forth. Send instruction to (re)plan from scratch, or refinement to adjust the current plan ("actually, only the empty rows"). The response embeds the rebuilt plan with measured counts and a 10-item preview of real extractions. Nothing is charged until approval; check plan.not_included — a non-empty list means part of the instruction will NOT happen.

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": "queued",
    "translation_mode": "<string>",
    "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>"
}

Requer batches:create. O planejamento é gratuito e pode ser refeito quantas vezes forem necessárias: nada é cobrado até você aprovar.

Instrução ou ajuste

Envie um ou outro, nunca ambos.

Campo	Significado
`instruction`	Planejar do zero. Substitui completamente qualquer plano anterior.
`refinement`	Ajustar o plano existente: “na verdade, apenas as linhas vazias”, “não altere as URLs”.

A distinção é importante quando o plano está quase certo: refinement mantém tudo o que você já definiu, enquanto instruction recomeça do zero e pode reinterpretar trechos que já estavam corretos.

Revise o plano antes de aprovar

A resposta inclui o plano reconstruído com contagens medidas (a quantidade real de itens e palavras encontrados no arquivo, e não uma estimativa baseada no tamanho), além de uma prévia de dez extrações reais.

Essas dez amostras são a verificação mais prática e econômica disponível. Elas exibem exatamente as strings que serão enviadas para tradução, permitindo identificar antes de qualquer cobrança se uma instrução acabou selecionando o campo errado.

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

{ "data": { "id": "<string>", "name": "<string>", "file_name": "<string>", "status": "queued", "translation_mode": "<string>", "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>" }

Preparar ou ajustar o plano

Instrução ou ajuste

Revise o plano antes de aprovar

Use these docs with your AI tools

Query these docs via MCP

Query these docs over HTTP

Read these docs as Markdown