AI Glot websiteOpen AI Glot
VertalingenEen vertaling annuleren
batches

Een vertaling annuleren

Stops within one task. Work already completed is charged (credit_cost in the response, because translation that ran has a real cost); the rest of the reservation is released. The batch lands in cancelled, a terminal status of its own since 2026-09-02. It used to be reported as failed carrying error.code: "cancelled", so any count of failures silently included deliberate stops; a cancelled batch now returns no error object at all.

POST/v1/batches/{batch_id}/cancel

Vereist batches:write. Stopt de vertaling binnen één taak, niet onmiddellijk: een taak die al bezig is, wordt eerst afgerond en niet halverwege afgebroken.

Wat er in rekening wordt gebracht

Al uitgevoerd werk wordt in rekening gebracht. In het antwoord staat hoeveel dat is in credit_cost. Het ongebruikte deel van de reservering wordt weer aan het saldo toegevoegd.

Dit is eerder een boekhoudkundig gegeven dan een restitutiebeleid: de uitgevoerde vertaling heeft modelcapaciteit verbruikt. Vroeg annuleren kost minder; annuleren tegen het einde kost bijna het volledige bedrag.

Wat er met de vertaling gebeurt

De batch krijgt de eindstatus cancelled. Dit is een zelfstandige eindstatus, geen soort fout. Er is geen error-object: de status alleen geeft aan wat er is gebeurd.

Dat onderscheid is belangrijk wanneer je de status opvraagt. cancelled betekent dat er niets misging: iemand heeft het werk bewust gestopt. failed betekent dat de vertaling niet kon worden voltooid; error.code geeft aan wat er misging. Behandel beide als eindstatus en stop met opvragen, maar alleen bij failed is opnieuw proberen of een waarschuwing versturen zinvol.

Wat de vertaling al had opgeleverd, kan niet worden gedownload. Een gedeeltelijk resultaat is geen vertaald bestand; dat teruggeven zou slechter zijn dan helemaal niets teruggeven.

Autorisaties

Authorizationbearerin headerrequired

Padparameters

batch_idstringrequired

Body

application/jsonrequired

Antwoord

application/json

Cancel a running translation

dataobjectrequired
request_idstringrequired

Use these docs with your AI tools

An AI agent can read this documentation directly. You do not need an account or an API key. Everything here is public and read-only.

Query these docs via MCP

Recommended

Add this server to Claude, Claude Code, Cursor, Mistral, or any tool that supports MCP. Your agent can then search AI Glot Docs documentation and read it in full, instead of answering from memory.

https://ai-glot.com/docs/mcp
  • searchFind the passages that answer a question.
  • fetchRead one page in full, as Markdown.
  • list_pagesSee every page in this documentation.

Query these docs over HTTP

The same tools also work as plain web requests. Use this for scripts, or for any tool that does not support MCP. There is one endpoint per tool. Arguments go in the query string, and the answer comes back as JSON.

https://ai-glot.com/docs/api/docs/search?query=custom+domain

Read the OpenAPI description. It is built from the same definitions as the tools, so it always matches what the endpoints do.

Read these docs as Markdown

Add .md to any page URL to get its Markdown source. You can also send the headerAccept: text/markdown to the page URL itself.

To read the whole documentation in one file, open llms-full.txt. For a short index of every page, open llms.txt.