batches

Plan vorbereiten oder verfeinern

Austausch in natürlicher Sprache. Senden Sie instruction, um den Plan von Grund auf (neu zu)planen, oder refinement, um den aktuellen Plan anzupassen ("eigentlich nur die leeren Zeilen"). Die Antwort bettet den neu erstellten Plan mit gemessenen Zahlen und einer 10-Element-Vorschau echter Extraktionen ein. Es wird nichts berechnet, bis die Genehmigung erfolgt; prüfen Sie plan.not_included - eine nicht leere Liste bedeutet, dass ein Teil der Anweisung NICHT ausgeführt wird.

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

Erfordert batches:create. Die Planung ist kostenlos und beliebig wiederholbar: Es fallen erst Kosten an, wenn Sie den Plan genehmigen.

Anweisung oder Verfeinerung

Übermitteln Sie entweder das eine oder das andere, nicht beides.

Feld	Bedeutung
`instruction`	Plan von Grund auf neu erstellen. Ersetzt jeden vorherigen Plan vollständig.
`refinement`	Den bestehenden Plan anpassen: „eigentlich nur die leeren Zeilen“, „URLs unverändert lassen“.

Dieser Unterschied ist wichtig, wenn ein Plan fast fertig ist: refinement behält alle bisherigen Festlegungen bei, während instruction von vorne beginnt und Abschnitte, mit denen Sie bereits zufrieden waren, unter Umständen neu interpretiert.

Plan vor der Genehmigung prüfen

Die Antwort enthält den neu erstellten Plan mit gemessenen Zählwerten (die tatsächliche Anzahl der in Ihrer Datei gefundenen Elemente und Wörter, keine bloße Größenschätzung) sowie eine Vorschau von zehn echten Extraktionen.

Diese zehn Beispiele bieten die einfachste Kontrollmöglichkeit. Sie zeigen exakt die Zeichenfolgen, die zur Übersetzung übermittelt werden – so fällt eine Anweisung, die unbeabsichtigt das falsche Feld erfasst hat, auf, bevor Kosten entstehen.

Antwort

application/json

Übersetzungsplan vorbereiten oder verfeinern

dataobjectrequired

Show child attributes

idstringrequired

namestring | nullrequired

file_namestring | nullrequired

statusstringrequired

Der aktuelle Status der Übersetzung. Alle sieben Werte: analyzing - die Dateistruktur wird gelesen, was einige Sekunden dauert; Polling durchführen. awaiting_instructions - die Datei wurde gelesen, aber es wurde noch nicht festgelegt, was übersetzt werden soll; plan-Call ausführen. awaiting_approval - ein Plan wartet auf die Zustimmung; approve-Call ausführen, der einzige Aufruf, der Credits verbraucht. translating - läuft; Polling durchführen. completed - Ergebnis abrufen. failed - der Durchlauf konnte nicht abgeschlossen werden; error lesen. cancelled - jemand hat den Vorgang absichtlich gestoppt; ebenfalls ein Endzustand und kein Fehler. Die letzten drei sind Endzustände: Polling beenden.

quality_tierstring | nullrequired

word_countinteger | nullrequired

credit_costinteger | nullrequired

is_samplebooleanrequired

archivedbooleanrequired

progressobjectrequired

errorobject | nullrequired

created_atstring | nullrequired

completed_atstring | nullrequired

next_actionstring

Der nächste auszuführen Call, sodass ein Client status nicht selbst zuordnen muss. provide_instruction - plan-Call mit einer Anweisung ausführen. review_plan - der bepreiste Plan ist eingebettet; plan.not_included prüfen, dann genehmigen. wait - erneut pollen; progress.estimated_seconds_remaining gibt die verbleibende Zeit an. download - Ergebnis abrufen. read_error - der Durchlauf ist ohne Ergebnis beendet; error lesen (und status gibt an, ob er abgebrochen wurde oder fehlgeschlagen ist). Fehlt nur bei einem veralteten CSV-Batch vor dem 2026-08-31, der keinen Plan besitzt; jede seitdem erstellte Übersetzung antwortet.

planobject | null

suggested_instructionsstring[] | null

request_idstringrequired

Plan vorbereiten oder verfeinern

Anweisung oder Verfeinerung

Plan vor der Genehmigung prüfen

Antwort

Use these docs with your AI tools

Query these docs via MCP

Query these docs over HTTP

Read these docs as Markdown