batches

Annuler une traduction

S'arrête dans le délai d'une tâche. Le travail déjà effectué est facturé (credits_charged dans la réponse, car une traduction exécutée a un coût réel); le reste de la réservation est libéré. Le lot passe en cancelled, un état terminal propre depuis le 2026-09-02. Auparavant, il était rapporté comme failed avec error.code: "cancelled", donc tout comptage d'échecs incluait silencieusement les arrêts volontaires; un lot annulé ne retourne désormais plus d'objet error.

POST/v1/batches/{batch_id}/cancel

Request

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

import json
import requests

url = "https://api.ai-glot.com/v1/batches/<batch_id>/cancel"
headers = {
  "Authorization": "<api-key>",
  "Content-Type": "application/json"
}
payload = json.loads("{}")

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>/cancel", {
  method: "POST",
  headers: {
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({}),
});

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>/cancel");
curl_setopt($client, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($client, CURLOPT_HTTPHEADER, [
    "Authorization: <api-key>",
    "Content-Type: application/json",
]);
curl_setopt($client, CURLOPT_POSTFIELDS, "{}");
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>/cancel", bytes.NewBuffer([]byte("{}")))
  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>/cancel"))
    .header("Authorization", "<api-key>")
    .header("Content-Type", "application/json")
    .method("POST", HttpRequest.BodyPublishers.ofString("{}"))
    .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>/cancel")
request = Net::HTTP::Post.new(uri)
request["Authorization"] = "<api-key>"
request["Content-Type"] = "application/json"
request.body = "{}"

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>",
    "cancelled": true,
    "credits_charged": 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>"
}

Nécessite batches:write. L’arrêt s’effectue à la fin de la tâche en cours plutôt qu’instantanément, car une tâche lancée est terminée plutôt qu’abandonnée à moitié écrite.

Facturation

Le travail déjà effectué est facturé et la réponse indique le montant dans credits_charged. La partie non utilisée de la réservation est restituée au solde.

Il ne s’agit pas d’une politique de remboursement mais d’un fait comptable : la traduction exécutée a consommé de la capacité de modèle. Annuler tôt coûte moins cher, annuler vers la fin coûte presque le montant total.

État final de la traduction

Le lot passe au statut cancelled, qui est un état terminal propre et non un type d’échec. error.code est également "cancelled", ainsi l’appelant qui ne lit que l’erreur comprend tout de même la raison.

Cette distinction est importante lors du polling. cancelled signifie que rien n’a dysfonctionné : quelqu’un a arrêté le travail intentionnellement. failed signifie que la traduction n’a pas pu se terminer et error.code précise l’origine de l’erreur. Considérez les deux comme terminaux et arrêtez le polling, mais seul le statut failed justifie une tentative de relance ou une alerte.

Tout contenu déjà produit par la traduction n’est pas téléchargeable. Un résultat partiel n’est pas un fichier traduit, et en retourner un serait pire que de ne rien retourner.

Réponse

application/json

Annuler une traduction en cours

dataobjectrequired

Show child attributes

idstringrequired

cancelledbooleanrequired

credits_chargedintegerrequired

request_idstringrequired

Annuler une traduction

Facturation

État final de la traduction

Réponse

Use these docs with your AI tools

Query these docs via MCP

Query these docs over HTTP

Read these docs as Markdown