batches

Aprobar el plan y traducir

Consume créditos: se reserva el recuento de palabras medido en el plan según la calidad elegida (standard: 1 palabra = 1 crédito; lite: un tercio, redondeado al alza) y se liquida al finalizar. Devuelve el progreso inicial con estimated_seconds_remaining: desde aquí, realice el polling de la traducción mediante GET.

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

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

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>"
  }),
});

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>\"}");
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>\"}")))
  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>\"}"))
    .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>\"}"

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

Requiere batches:create. Esta es la llamada que consume créditos. Todo el proceso previo (creación, planificación y ajuste) es gratuito.

Cuánto cuesta

El recuento de palabras medido en el plan se reserva en el nivel de calidad que elijas y, posteriormente, se liquida según el consumo real una vez finalizada la traducción.

Calidad	Coste	Disponibilidad
`standard`	1 crédito por palabra	Todos los planes
`lite`	Un tercio de las palabras, redondeado al alza	Planes de pago

Dado que el recuento se mide directamente sobre el archivo en lugar de estimarse, la reserva coincide con el valor que viste en la respuesta del plan. Si el saldo no es suficiente para cubrirlo, la llamada fallará con insufficient_credits y no se reservará nada.

Sondeo posterior

La respuesta devuelve el progreso inicial, incluido estimated_seconds_remaining. A partir de ahí, sondea mediante GET /v1/batches/{batch_id} en lugar de llamar a approve de nuevo. Una segunda aprobación sobre una traducción en curso fallará con batch_not_awaiting_approval.

custom_instructions aplica directrices exclusivamente a este lote, complementando cualquier glosario del espacio de trabajo. No modifica el plan, por lo que no puede alterar qué se traduce, sino únicamente cómo.

Respuesta

application/json

Aprobar el plan e iniciar la traducción

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

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

Aprobar el plan y traducir

Cuánto cuesta

Sondeo posterior

Respuesta

Use these docs with your AI tools

Query these docs via MCP

Query these docs over HTTP

Read these docs as Markdown