API Reference
Complete reference for the Translation REST API.
API Reference
Complete reference for the Translation REST API.
Overview
Base URL: https://your-domain.com/api/v1
All requests and responses use JSON. Authentication is via Bearer token.
Authentication
Pass your operator token as a Bearer token in every request.
Authorization: Bearer opt_your-tokenCreate operator tokens in Account → Operator tokens. Each token is owned by your account and scoped to specific workspaces (and optionally projects).
Because a token can span multiple workspaces, endpoints accept a workspace parameter (slug or id). It is required when the token can access more than one workspace.
Endpoints
| Method | Endpoint | Description |
|---|---|---|
| POST | /translate | Translate a text string |
| POST | /detect | Detect the language of one text or a batch |
| GET | /usage | Get current month usage |
Language Codes
Common supported language codes:
| Code | Language | Code | Language |
|---|---|---|---|
en-US | English (US) | fr | French |
de | German | es | Spanish |
it | Italian | pt | Portuguese |
ja | Japanese | zh | Chinese |
ko | Korean | ru | Russian |
ar | Arabic | nl | Dutch |
pl | Polish | sv | Swedish |
Rate Limits & Quotas
Requests are rate-limited per operator token. Monthly character quotas are enforced per workspace based on your plan. Language detection (/detect) is rate-limited but does not count against the character quota.
| Plan | Monthly Characters | Operator tokens per workspace |
|---|---|---|
| Free | 50,000 | 1 |
| Pro | Custom | 10 |
| Enterprise | Unlimited | Unlimited |