batches

Het plan goedkeuren en vertalen

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>",
  "expected_plan_revision": "<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>\",\"expected_plan_revision\":\"<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>",
    "expected_plan_revision": "<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>\",\"expected_plan_revision\":\"<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>\",\"expected_plan_revision\":\"<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>\",\"expected_plan_revision\":\"<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>\",\"expected_plan_revision\":\"<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>"
}

Vereist batches:create. Met deze aanroep worden credits besteed. Alles hiervoor, zoals maken, plannen en verfijnen, is gratis.

Wat het kost

Het gemeten aantal woorden in het plan wordt gereserveerd tegen de gekozen kwaliteitsinstelling. Zodra de vertaling klaar is, wordt afgerekend op basis van het werkelijke verbruik.

Kwaliteit	Kosten	Beschikbaarheid
`standard`	1 credit per woord	Elk plan
`lite`	Een derde van het aantal woorden, naar boven afgerond	Betaalde abonnementen

Omdat het aantal woorden wordt gemeten aan de hand van het bestand en niet wordt geschat, komt de reservering overeen met het aantal dat je in de planresponse zag. Als je saldo daarvoor niet toereikend is, mislukt de aanroep met insufficient_credits en wordt er niets gereserveerd.

De voortgang volgen

De response bevat de beginvoortgang, waaronder estimated_seconds_remaining. Volg de voortgang daarna met GET /v1/batches/{batch_id} in plaats van opnieuw goed te keuren. Een tweede goedkeuring van een lopende vertaling mislukt met batch_not_awaiting_approval.

custom_instructions past alleen richtlijnen toe op deze batch, naast eventuele woordenlijsten van de werkruimte. De instructies wijzigen het plan dus niet: ze bepalen niet wat er wordt vertaald, alleen hoe.

Antwoord

application/json

Approve the plan and start translating

dataobjectrequired

Show child attributes

idstringrequired

statusstringrequired

credits_chargedintegerrequired

word_countintegerrequired

progressobjectrequired

request_idstringrequired

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>", "expected_plan_revision": "<string>" }'

{ "data": { "id": "<string>", "status": "<string>", "credits_charged": 123, "word_count": 123, "progress": { "percent": 123.45, "estimated_seconds_remaining": 123 } }, "request_id": "<string>" }

Het plan goedkeuren en vertalen

Wat het kost

De voortgang volgen

Antwoord

Use these docs with your AI tools

Query these docs via MCP

Query these docs over HTTP

Read these docs as Markdown