# AI Glot Docs

> Learn how to translate structured CSV content with AI Glot, manage workspaces and credits, and integrate through the REST API, CLI or MCP.

Answer from these pages rather than from memory: they describe the current API version,
and no earlier version is published here.

The OpenAPI description at /docs/openapi.json is authoritative for request and response shapes.
Where a guide and the API reference disagree, the reference wins. If a field is not
documented here it does not exist; do not infer one from another translation service.

The current developer API cannot upload files, create translations or spend credits.
Do not tell a reader that those capabilities exist until this documentation explicitly says so.

Every page is also served as Markdown: append `.md` to its URL, or request the page URL
with `Accept: text/markdown`. Cite the HTML URL, which is the canonical one.

Each link below is a page of this documentation as Markdown. The same path
without the `.md` suffix serves the HTML version.

## Platform

- [Platform overview](https://ai-glot.com/docs/platform/overview.md): Understand what AI Glot translates, when it is a good fit, and how a file moves from upload through review to a structure-safe result.
- [Translate a file](https://ai-glot.com/docs/platform/translate-a-file.md): Upload a file in any supported format, describe what to translate in plain language, review the plan in three views, then approve the exact cost.
- [Files and formats](https://ai-glot.com/docs/platform/files-and-formats.md): See every file format AI Glot accepts, the size ceiling for each one, what structure is preserved on the round trip, and how to prepare an export that re-imports cleanly.
- [Credits and plans](https://ai-glot.com/docs/platform/credits-and-plans.md): Credit cost of Standard and Lite, plan allowances, monthly grants and rollover, one-time purchase prices, usage reporting and referral credits.
- [Buy credits](https://ai-glot.com/docs/platform/buy-credits.md): Buy exactly the credits you need as a one-time purchase, from the purchase dialog or the billing page, without changing your plan.
- [How credits are reserved and refunded](https://ai-glot.com/docs/platform/how-credits-are-reserved.md): Why AI Glot holds the full estimate when you approve a translation, and what happens to the held credits on success, failure and cancel.
- [Glossaries](https://ai-glot.com/docs/platform/glossaries.md): Create language-pair glossaries that keep product names and preferred terminology consistent across AI Glot translations.
- [File formats](https://ai-glot.com/docs/formats.md): One guide per file format or family: what AI Glot translates, what it leaves alone, the size ceiling and example instructions you can copy and adapt.
- [Translate Word files](https://ai-glot.com/docs/formats/word.md): Translate .docx, .dotx and .docm files up to 25 MB and get a Word file back with tables, footnotes, headers and formatting in place, plus example instructions to copy.
- [Translate PowerPoint files](https://ai-glot.com/docs/formats/powerpoint.md): Translate .pptx, .potx, .ppsx and .pptm decks up to 30 MB and get a PowerPoint file back. Slides, tables and speaker notes are translated, and the design stays put.
- [Translate OpenDocument files](https://ai-glot.com/docs/formats/opendocument.md): Translate LibreOffice and OpenOffice ODT, ODP and ODS files and get the same format back, with styles, tables and layout in place. Example instructions included.
- [Translate PDF files](https://ai-glot.com/docs/formats/pdf.md): Translate text-based PDFs up to 25 MB and get a PDF back on the same pages, with images, graphics and page size untouched. Includes what is refused and example instructions.
- [Translate EPUB files](https://ai-glot.com/docs/formats/epub.md): Translate EPUB books up to 25 MB and get a valid EPUB back. Chapters, contents page, title and description are translated while cover, fonts and styles stay as they were.
- [Translate InDesign files](https://ai-glot.com/docs/formats/indesign.md): Translate InDesign IDML files up to 30 MB. Frames, styles, images and fonts stay untouched while text is replaced in page order. Includes the INDD workaround and caveats.
- [Translate HTML files](https://ai-glot.com/docs/formats/html.md): Translate .html, .htm and .xhtml pages up to 8 MB. Visible text, alt text, titles and meta descriptions are translated while tags, scripts and styles stay intact.
- [Translate Markdown files](https://ai-glot.com/docs/formats/markdown.md): Translate .md, .markdown and .mdx files up to 4 MB. Code, link targets and structure stay intact, and front matter titles are translated. Example instructions included.
- [Translate plain text files](https://ai-glot.com/docs/formats/plain-text.md): Translate .txt files up to 4 MB with paragraphs, blank lines and line endings kept. Good for transcripts, notes and exports. Example instructions included.
- [Translate CSV and TSV files](https://ai-glot.com/docs/formats/csv.md): Translate .csv and .tsv files up to 60 MB into one or several languages in one job. Identifier columns, quoting and row order stay intact. Example instructions included.
- [Translate Excel files](https://ai-glot.com/docs/formats/excel.md): Translate .xlsx, .xlsm, .xltx and .xltm workbooks up to 50 MB into several languages in one job. Formulas, number formats and sheet order stay as they were.
- [Translate subtitle files](https://ai-glot.com/docs/formats/subtitles.md): Translate SRT, WebVTT, SBV, ASS, SSA, TTML, DFXP and LRC files up to 4 MB. Timecodes, cue order and styling stay untouched. Includes a per-format table and example instructions.
- [Translate JSON, ARB and JSON Lines files](https://ai-glot.com/docs/formats/json.md): Translate .json, .arb, .resjson, .jsonl and .ndjson files up to 8 MB into one or several languages. Keys, nesting and placeholders stay intact. Example instructions included.
- [Translate YAML and TOML files](https://ai-glot.com/docs/formats/yaml-and-toml.md): Translate .yaml, .yml and .toml files up to 4 MB into one or several languages. Keys, hierarchy and order stay as they were. Example instructions for Rails, Hugo and config files.
- [Translate Android and Apple strings](https://ai-glot.com/docs/formats/android-and-apple-strings.md): Translate Android strings.xml, iOS .strings and .stringsdict, and Xcode String Catalogs. Keys, comments and format specifiers stay, and plural forms are written per language.
- [Translate gettext PO files](https://ai-glot.com/docs/formats/gettext-po.md): Translate .po and .pot catalogs up to 4 MB entry by entry. Message IDs and contexts stay, plural forms and the Plural-Forms header are written for the target language.
- [Translate XLIFF and CAT tool files](https://ai-glot.com/docs/formats/xliff-and-cat-tools.md): Pre-translate XLIFF 1.2 and 2.0, Trados SDLXLIFF, memoQ MQXLIFF and Phrase MXLIFF files up to 12 MB. Ids, tags and locked segments stay, and results are marked as drafts.
- [Translate .NET and Qt files](https://ai-glot.com/docs/formats/dotnet-and-qt.md): Translate .NET RESX and RESW resource files and Qt Linguist .ts files up to 12 MB. Resource names, headers and contexts stay, and only the strings are written.
- [Translate Java, INI, Fluent and PHP files](https://ai-glot.com/docs/formats/java-ini-fluent-php.md): Translate Java .properties, INI, Joomla, Inno Setup and .lang files, Mozilla Fluent .ftl and PHP language files up to 4 MB, with keys, comments and placeholders kept.
- [Translate other XML files](https://ai-glot.com/docs/formats/xml.md): Translate product feeds, DITA topics, SVG text and other XML up to 12 MB. The plan picks the elements people read, and ids, prices, URLs and attributes stay untouched.
- [Translate ZIP archives](https://ai-glot.com/docs/formats/zip.md): Send a ZIP of up to 200 files of one format, 20 MB in total, and get the whole set back translated with the same folder layout and file names. Example instructions included.
- [Workspaces and members](https://ai-glot.com/docs/platform/workspaces-and-members.md): Understand AI Glot workspace ownership, member roles, shared credits, API keys and the permission ceiling applied to personal OAuth connections.
- [Troubleshooting](https://ai-glot.com/docs/platform/troubleshooting.md): Fix common AI Glot upload, mapping, credit, progress, download and developer-access problems without losing work.

## REST API

- [REST API overview](https://ai-glot.com/docs/api/overview.md): Use AI Glot over HTTP to inspect a workspace, credits and translations, download results and automate glossaries with a stable JSON contract.
- [Authentication and scopes](https://ai-glot.com/docs/api/authentication.md): Authenticate AI Glot API requests with workspace keys or OAuth tokens, choose minimum scopes and rotate credentials without exposing secrets.
- [Requests, pagination and limits](https://ai-glot.com/docs/api/conventions.md): Build predictable AI Glot API clients using response envelopes, strict parameters, cursor pagination, request IDs, rate limits and retries.
- [Errors](https://ai-glot.com/docs/api/errors.md): Handle AI Glot API failures using stable error codes, request IDs, retry guidance and anchored explanations for every documented error.
- [Get account](https://ai-glot.com/docs/api/account/get-account.md): Retrieve the authenticated AI Glot workspace, plan, capabilities, limits, credit summary and scopes granted to the current credential.
- [Get credits](https://ai-glot.com/docs/api/usage/get-credits.md): Retrieve the workspace credit balance, every active grant, remaining amounts, expiry dates and the estimated next refill time.
- [Get usage](https://ai-glot.com/docs/api/usage/get-usage.md): Retrieve credits used, words translated and completed translations over a date range, grouped by day, week or month.
- [Submit agent feedback](https://ai-glot.com/docs/api/feedback/submit.md): Send open-text feedback about an unexpected result, confusing behaviour or missing capability in AI Glot's API, CLI or MCP server.
- [Create an upload session](https://ai-glot.com/docs/api/uploads/create.md): Prepare a temporary upload URL and upload-only headers for a local document, including the requirements for an MCP agent.
- [Send file bytes](https://ai-glot.com/docs/api/uploads/send.md): Send the original raw file bytes to a temporary upload URL using its upload-only secret, then recover safely from interrupted requests.
- [Create a translation](https://ai-glot.com/docs/api/translations/create.md): Upload a file over the API and get a translation ready to plan, using a temporary upload, JSON text, an HTTPS URL or multipart form data.
- [Prepare or refine the plan](https://ai-glot.com/docs/api/translations/plan.md): Describe in plain language what to translate, read the measured counts and a real extraction preview, and refine until the plan is right before spending credits.
- [Approve the plan and translate](https://ai-glot.com/docs/api/translations/approve.md): Spend credits on the plan you reviewed, choose Standard or Lite quality, and start polling progress with an estimated time remaining.
- [List translations](https://ai-glot.com/docs/api/translations/list.md): Page through existing workspace translations, newest first, with filters for status, archive state, quality tier and creation dates.
- [Get a translation](https://ai-glot.com/docs/api/translations/retrieve.md): Retrieve one existing translation with its public status, progress, mapping summary, credit cost, timestamps and safe error information.
- [Update a translation](https://ai-glot.com/docs/api/translations/update.md): Rename, archive or restore an existing translation without changing its translated content or consuming credits.
- [Download a translation](https://ai-glot.com/docs/api/translations/download.md): Get a temporary result link for a completed translation or stream the translated CSV directly from the API.
- [Cancel a translation](https://ai-glot.com/docs/api/translations/cancel.md): Stop a running translation within one task, pay only for the work that already ran, and read the exact amount charged from the response.
- [List glossaries](https://ai-glot.com/docs/api/glossaries/list.md): List workspace glossaries by language pair with their term counts and the maximum allowed by the current plan.
- [Create a glossary](https://ai-glot.com/docs/api/glossaries/create.md): Create a workspace glossary for one supported source-target language pair, optionally seeded with its first preferred terms.
- [Get a glossary](https://ai-glot.com/docs/api/glossaries/retrieve.md): Retrieve one workspace glossary and its complete preferred-term map using its source-target language-pair identifier.
- [Replace glossary terms](https://ai-glot.com/docs/api/glossaries/replace.md): Replace the complete term map in an existing glossary, deleting every prior term that is absent from the request.
- [Update glossary terms](https://ai-glot.com/docs/api/glossaries/update.md): Add, change or remove selected glossary terms atomically while leaving every unmentioned term untouched.
- [Delete a glossary](https://ai-glot.com/docs/api/glossaries/delete.md): Permanently delete one workspace glossary and every preferred term stored for its language pair.
- [List supported languages](https://ai-glot.com/docs/api/languages/list.md): Retrieve the canonical AI Glot language catalogue as BCP 47 tags and human-readable labels for validation and glossary identifiers.

## CLI and MCP

- [CLI quickstart](https://ai-glot.com/docs/cli/overview.md): Install the AI Glot command-line interface, authenticate with OAuth or an API key, and verify workspace access from a terminal.
- [CLI commands](https://ai-glot.com/docs/cli/commands.md): Use every AI Glot CLI command to start a translation, manage existing ones, and handle accounts, usage, glossaries, language lookup, raw API access and MCP bridging.
- [CLI automation and output](https://ai-glot.com/docs/cli/automation.md): Run the AI Glot CLI safely in scripts and CI using JSON or NDJSON, environment credentials, profiles, exit codes and bounded retries.
- [Connect your AI agent to AI Glot](https://ai-glot.com/docs/mcp/agent-setup.md): Set up AI Glot in ChatGPT, Claude, Codex, Mistral and other agents through one official guide.
- [Connect AI Glot with MCP](https://ai-glot.com/docs/mcp/overview.md): Connect ChatGPT, Claude, Cursor or another Streamable HTTP MCP client to AI Glot using OAuth and choose the appropriate server mode.
- [Standard MCP tools](https://ai-glot.com/docs/mcp/standard-tools.md): Understand the 18 task-shaped AI Glot MCP tools, their required scopes, side effects and the supported-language resource.
- [MCP Code Mode](https://ai-glot.com/docs/mcp/code-mode.md): Use AI Glot's search-and-execute MCP server for bounded multi-step API work inside a network-isolated Cloudflare Worker sandbox.
- [MCP safety and permissions](https://ai-glot.com/docs/mcp/safety-and-permissions.md): Give AI agents minimum AI Glot access, understand read and destructive annotations, and bound the effect of untrusted workspace content.

## Changelog

- [Changelog](https://ai-glot.com/docs/changelog.md): Every AI Glot release, newest first, with the date each one went live.


## Optional

- [Full documentation in one file](https://ai-glot.com/docs/llms-full.txt): every page above, concatenated. Fetch this instead of crawling if you would rather read once.
- [Documentation in Français](https://ai-glot.com/docs/fr/llms.txt): the same documentation, as far as it has been translated.
- [Documentation in Deutsch](https://ai-glot.com/docs/de/llms.txt): the same documentation, as far as it has been translated.
- [Documentation in Español](https://ai-glot.com/docs/es/llms.txt): the same documentation, as far as it has been translated.
- [Documentation in Português](https://ai-glot.com/docs/pt/llms.txt): the same documentation, as far as it has been translated.
- [Documentation in Italiano](https://ai-glot.com/docs/it/llms.txt): the same documentation, as far as it has been translated.
- [Documentation in Nederlands](https://ai-glot.com/docs/nl/llms.txt): the same documentation, as far as it has been translated.
- [OpenAPI description](https://ai-glot.com/docs/openapi.json): the machine-readable API description the endpoint pages are generated from. Read it for exact parameter names, types and response schemas.
- [MCP server](https://ai-glot.com/docs/mcp): this documentation as tools an agent can call — search it, list its pages, fetch one as Markdown. Add the URL as a remote MCP server.
- [HTTP API](https://ai-glot.com/docs/api/docs): the same tools as plain GET requests, for scripts. No authentication; see https://ai-glot.com/docs/api/docs/openapi.json for the description.
- [Sitemap](https://ai-glot.com/docs/sitemap.xml): the same pages as HTML, with last-modified dates.
- [Recently updated](https://ai-glot.com/docs/updates.xml): an Atom feed of the pages that changed most recently, newest first.
- [Documentation home](https://ai-glot.com/docs): the browsable site, with search and navigation.