batches

Übersetzung abbrechen

Stoppt innerhalb einer Aufgabe. Bereits abgeschlossene Arbeit wird berechnet (credits_charged in der Antwort, da ein durchgelaufener Übersetzungsvorgang reale Kosten verursacht); der Rest der Reservierung wird freigegeben. Der Batch landet in cancelled, einem eigenen Endzustand seit dem 2026-09-02. Zuvor wurde dies als failed mit error.code: "cancelled" gemeldet, sodass jede Zählung von Fehlern absichtliche Stopps stillschweigend enthielt; ein stornierter Batch gibt nun überhaupt kein error-Objekt mehr zurück.

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

Erfordert batches:write. Der Abbruch erfolgt innerhalb eines Tasks und nicht sofort, da ein laufender Task abgeschlossen und nicht halbfertig abgebrochen wird.

Kosten

Bereits abgeschlossene Arbeiten werden berechnet; der Betrag wird in credits_charged angegeben. Der nicht genutzte Teil der Reservierung wird dem Guthaben wieder gutgeschrieben.

Dies ist weniger eine Erstattungsrichtlinie als vielmehr eine buchhalterische Tatsache: Die durchgeführte Übersetzung hat Modellkapazitäten verbraucht. Ein früher Abbruch kostet weniger, ein Abbruch kurz vor Ende nahezu den vollen Betrag.

Status der Übersetzung

Der Batch endet im Status cancelled. Dies ist ein eigener Endstatus und keine Art von Fehler. error.code ist ebenfalls "cancelled", sodass ein Aufrufer, der nur den Fehler ausliest, dennoch den Grund erfährt.

Diese Unterscheidung ist beim Polling wichtig. cancelled bedeutet, dass nichts schiefgelaufen ist, sondern jemand die Arbeit absichtlich gestoppt hat. failed bedeutet, dass die Übersetzung nicht abgeschlossen werden konnte, und error.code gibt an, was genau fehlgeschlagen ist. Behandeln Sie beide als Endstatus und beenden Sie das Polling, aber nur failed rechtfertigt einen erneuten Versuch oder eine Alarmierung.

Alle bereits produzierten Inhalte der Übersetzung können nicht heruntergeladen werden. Ein partielles Ergebnis ist keine übersetzte Datei, und die Rückgabe eines solchen wäre schlechter als gar keine Rückgabe.

Antwort

application/json

Laufende Übersetzung abbrechen

dataobjectrequired

Show child attributes

idstringrequired

cancelledbooleanrequired

credits_chargedintegerrequired

request_idstringrequired

Übersetzung abbrechen

Kosten

Status der Übersetzung

Antwort

Use these docs with your AI tools

Query these docs via MCP

Query these docs over HTTP

Read these docs as Markdown