# Nitro (NitroTranslate)

> Professional human translation as an API. Real native-speaking translators — not
> machine translation — in 80+ languages, with no minimum order (translate as little
> as one word) and typical turnaround of 2-24 hours. AI agents can order and pay for human translations per request via
> the Machine Payments Protocol (MPP), without creating an account or holding a balance.

The API base URL is `https://api.nitrotranslate.com/v1`. Full reference, request and
response schemas, and the authoritative OpenAPI specification live on the docs site
below — prefer those over this file for field-level detail.

## API endpoints

- `GET /v1/rates`: Current pricing rates for all supported language pairs (per 1000 characters, USD).
- `POST /v1/calculate`: Estimate translation cost per target language before ordering.
- `POST /v1/translate`: Submit content for translation and create orders.
- `GET /v1/orders`: List orders, newest first by default, with pagination.
- `GET /v1/orders/{id}`: Fetch a single order with its full details, including translated text.
- `DELETE /v1/orders/{id}`: Remove an order (only while in QUEUE status).
- `GET /v1/account`: Retrieve account details (balance and reserved funds).

Orders move through `QUEUE` -> `PROGRESS` -> `DONE`. `REVISION` marks a completed order
the customer reopened; once rework resumes it reports as `PROGRESS` again. Translated
text is delivered asynchronously — poll `GET /v1/orders/{id}` until `status` is `DONE`
and read `target_text`.

Content is submitted as a `resource` with a MIME `type` of `text/plain`, `text/html`,
`application/json`, or `text/x-objcstrings`, plus the payload in `data`.

## Authentication

- [Authentication](https://docs.nitrotranslate.com/authentication.md): Three schemes — Basic (API key as username), Bearer (API key as token), and Payment (MPP credential).
- [Agentic Flow](https://docs.nitrotranslate.com/agentic-flow.md): Pay per request with the Machine Payments Protocol — no account or balance required. A request without an `Authorization` header returns a `402` challenge; retry with `Authorization: Payment <credential>`.
- [Machine Payments Protocol (MPP)](https://mpp.dev): The open payment protocol used for the agentic flow. MPP handles payment processing; your client never touches card details directly.

API keys for the account-based flow are generated at
`https://app.nitrotranslate.com/login?continue=/customer/settings#api-keys`.

## Docs

- [Introduction](https://docs.nitrotranslate.com/introduction.md): Welcome to the NitroTranslate human translation API.
- [API Overview](https://docs.nitrotranslate.com/api-reference/overview.md): The NitroTranslate human translation API.
- [OpenAPI specification](https://github.com/nitrotranslate/proto/releases/latest/download/openapi.yaml): Canonical machine-readable spec (OpenAPI 3.1). Also served as https://nitrotranslate.com/openapi.yaml
- [Errors](https://docs.nitrotranslate.com/errors.md): HTTP status codes and error responses.
- [Supported Languages](https://docs.nitrotranslate.com/languages.md): Language codes accepted by the API.
- [Translate](https://docs.nitrotranslate.com/api-reference/translation/translate.md): Submit content for translation and create orders.
- [Calculate](https://docs.nitrotranslate.com/api-reference/translation/calculate.md): Estimate translation cost per target language.
- [List Rates](https://docs.nitrotranslate.com/api-reference/rates/list.md): Current pricing rates for all supported language pairs.
- [Get Order](https://docs.nitrotranslate.com/api-reference/orders/get.md): Fetch a single order with its full details.
- [List Orders](https://docs.nitrotranslate.com/api-reference/orders/list.md): List orders, newest first by default, with pagination.
- [Delete Order](https://docs.nitrotranslate.com/api-reference/orders/delete.md): Remove an order (only while in QUEUE status).
- [Get Account](https://docs.nitrotranslate.com/api-reference/account/get.md): Retrieve account details (balance and reserved funds).
- [Full docs index](https://docs.nitrotranslate.com/llms.txt): The docs site's own llms.txt.

## About

- [Translation API](https://nitrotranslate.com/translation-api): Product overview of the human translation API.
- [API for AI agents](https://nitrotranslate.com/translation-api-noauth): The no-account agentic flow, aimed at AI agents.
- [Supported file formats](https://nitrotranslate.com/supported-file-formats): Formats Nitro can translate.
- [Languages](https://nitrotranslate.com/languages): Languages and language pairs offered.
- [Case studies](https://nitrotranslate.com/case-studies): Customer results.
- [About Nitro](https://nitrotranslate.com/about-us): Nitro is a professional translation service by Alconost.

## Contact

- Email: nitro@alconost.com
- [Terms of service](https://alconost.com/en/legal/terms-of-service)
- [Privacy policy](https://alconost.com/en/legal/privacy-policy)