---
title: "Translate V1"
method: POST
path: "/v1/translate"
---

# Translate V1

`POST /v1/translate`

## Request

- Base URL: `https://www.polytranslator.com/api`
- URL: `https://www.polytranslator.com/api/v1/translate`
- Auth: HTTP bearer

## Request body

- TranslateV1Request
  - `src` string, required
  - `tgt` string, required
  - `text` string, required
  - `tier` 'fast' | 'advanced'
  - `max_credits` integer, nullable

## Response `200`

Successful Response

- TranslateV1Response
  - `text` string, required
  - `usage` TranslateV1Usage, required
    - `chars` integer, required
    - `credits_charged` integer, required
  - `request_id` string, required
  - `credits_remaining` integer, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/polytranslator/apis/polytranslator-api.md) · [All operations](https://skmtc.dev/polytranslator/apis/polytranslator-api/llms.txt) · [OpenAPI document](https://skmtc.dev/polytranslator/apis/polytranslator-api/revisions/744f2e6d5396?raw)