Taia
Start Free
Translation API

Automate Translation with REST API

Integrate Taia's AI translation into your apps, CMS, or CI/CD pipelines. Upload files, create projects, get instant translations—all programmatically.

View API Docs See Pro Plan
REST API + JSON 65+ file formats 204 languages

Simple API Workflow

Create projects, upload files, translate with AI, and download results

1. Create Project

POST /projects with project_name, source_language, target_languages, files, and optional TMs/Glossaries.

2. Request Translation

POST /projects/{id}/instant-mt to translate with AI, or kick off a professional translation order. Processing is async.

3. Check Status

Poll /projects/{id}/status—or skip polling and subscribe to webhooks for real-time events.

4. Download Files

GET /projects/{id}/final-files to fetch translated files as a ZIP package when ready.

How It Fits Together

Three concepts power every integration: API keys, scopes, and webhooks

1. Create an API key

Generate keys from your account settings. The full key is shown once at creation—copy it immediately. Every key starts with the taia_pk_live_ prefix and is sent with every request:

Authorization: Api-Key
taia_pk_live_YOUR_KEY

2. Scope keys per team

Issue multiple keys—each scoped to a user, team, or organization. A team-scoped key only sees that team's projects and consumes that team's billing account & credit quota. Perfect for isolating staging from production, or one integration per business unit.

  • Separate billing account per team
  • Independent credit quota & analytics
  • Granular access — revoke one key without breaking others

3. Register webhooks (optional)

Skip polling. Register up to 5 webhooks per key, each subscribed to any of 12 event types across the project and order lifecycle. Every delivery is signed with an HMAC secret (shown once) and retried on failure.

project.created · project.mt_completed
project.quote_ready · order.delivered
…and 8 more

Webhooks are scoped to the API key that registered them.

Mental model: API key → identifies who is calling and which billing account/quota to use → webhooks registered against that key receive callbacks for resources owned by that scope. Revoking a key disables every webhook attached to it.

Manage Keys from Your Dashboard

Generate, list, and revoke API keys at any scope from your account settings

Generate API Key

Click below to generate a new API key. You will only see it once, so be sure to copy it when it appears.

Your New API Key

taia_pk_live_-69M_MwIsLxzxBvC__Hst32vKXQXPG-N

Warning: Copy this key now. You won't be able to view it again.

API Key Management

Created At Preview Status Action
24/08/2026, 08:46:18 taia_pk_live_*****KXQXPG-N Active
List of your API keys.

Generate API keys at the user, team, or organization level—each key inherits the permissions and quota of its owner.

Quick Start Example

Create a project and get AI translation in just a few API calls

Create Project & Translate
cURL 
# 1. Upload files and create a project
curl -X POST https://api.taia.io/api/public/v1/projects \
  -H "Authorization: Api-Key taia_pk_live_YOUR_KEY" \
  -F "project_name=Q3 Product Launch" \
  -F "source_language=en" \
  -F "target_languages=es,de,fr" \
  -F "files[]=@/path/to/document.docx"

# Response:
# {
#   "message": "Project created successfully. Files are being processed.",
#   "project_id": "d4a892de-7e37-4eb7-9c20-18bca0aaba4e",
#   "status_url": "/api/public/v1/projects/d4a892de-.../status"
# }

# 2. Request AI translation (Standard or Advanced AI)
curl -X POST https://api.taia.io/api/public/v1/projects/d4a892de-7e37-4eb7-9c20-18bca0aaba4e/instant-mt \
  -H "Authorization: Api-Key taia_pk_live_YOUR_KEY"

# Response: Translation started

# 3. Check translation status (or skip polling and use webhooks)
curl -X GET https://api.taia.io/api/public/v1/projects/d4a892de-7e37-4eb7-9c20-18bca0aaba4e/status \
  -H "Authorization: Api-Key taia_pk_live_YOUR_KEY"

# Response: { "data": { "project_id": "...", "status": "completed" } }

# 4. Download translated files as a ZIP
curl -X GET https://api.taia.io/api/public/v1/projects/d4a892de-7e37-4eb7-9c20-18bca0aaba4e/final-files \
  -H "Authorization: Api-Key taia_pk_live_YOUR_KEY" \
  -o translated-files.zip

Full documentation: View complete API reference with all endpoints, request/response schemas, and authentication details in our Postman collection

Everything You Need to Automate Translation

Full-featured REST API with comprehensive project management capabilities

File Upload & Download

Upload files to projects via API. Download translated files as ZIP package. Supports 65+ file formats including DOCX, XLSX, JSON, HTML.

Async Processing

Submit translation requests and check status with GET requests. Multiple projects process simultaneously. No blocking operations.

TM & Glossary Support

Attach translation memories and glossaries to projects via API. Ensure consistency and terminology compliance programmatically.

204 Languages

All Taia-supported languages available via API. Same quality AI translation engine as the web platform.

Secure Authentication

API keys authenticated via the Authorization header. Generate and revoke keys anytime at the user, team, or organization scope.

REST + JSON

Standard REST API with JSON request/response format. Works with any programming language or HTTP client.

Webhooks

Subscribe to 12 event types (project, order, task, and quote lifecycle) with HMAC-signed delivery, automatic retries, and a deliveries log. No polling required.

Professional Translation

Beyond AI: request a quote, pick a service tier (Essential, Enhanced, Ultimate), choose a delivery date, and place an order—all via API. ISO 17100 certified human translation.

Common API Use Cases

Automate translation workflows across your entire tech stack

CMS & Website Integrations

Automatically translate content when published in your CMS. Perfect for WordPress, Contentful, Strapi, or custom systems.

  • Auto-translate new blog posts
  • Localize product descriptions
  • Sync translations back to CMS
  • Maintain multilingual site maps

CI/CD Pipeline Automation

Integrate translation into GitHub Actions, GitLab CI, or Jenkins. Translate on every deployment.

  • Auto-translate UI strings on commit
  • Localize docs before deployment
  • Update language files automatically
  • Version control translated content

SaaS Product Localization

Automate translation of your SaaS product, marketing content, documentation, and user onboarding flows.

  • Translate app UI and features
  • Localize marketing content
  • Automate docs translation
  • Onboarding in every language

E-commerce Catalog Automation

Automatically translate product catalogs, descriptions, and attributes. Keep all markets in sync.

  • Translate new products automatically
  • Localize seasonal campaigns
  • Update descriptions in bulk
  • Maintain brand voice across markets

Coming Soon to the API

New features in development to expand your automation capabilities

Coming Soon

Connected Apps API

Streamline app and website localization with our new Connected Apps API. Collect strings with context, choose translation quality (AI-only, human-reviewed, or professional), and sync translations back automatically.

  • Automatic string extraction from your codebase
  • Context-aware translations with screenshots
  • Flexible quality levels: AI, human-reviewed, or ISO-certified professional
  • Bidirectional sync with your apps and websites

Comprehensive API Documentation

Everything you need to integrate Taia API into your workflow

Postman Collection

Complete API documentation with all endpoints, request/response examples, and authentication setup. Import the collection and start testing immediately with pre-configured requests.

FAQ

Common Questions About the Translation API

Authentication, formats, pricing, and how the API fits into Taia's AI translation engine

What is the Taia Translation API?

The Taia Translation API is a REST API that lets developers create translation projects, upload files, request AI translation, and download results programmatically instead of through the taia.io web interface. It uses the same AI translation engine as the Translation Studio web platform, and supports the same 204 languages and 65+ file formats. It's included with the Pro plan for teams automating translation inside a CMS, CI/CD pipeline, or custom application.

How do I authenticate API requests?

Every request must include an Authorization: Api-Key header carrying a key that starts with the taia_pk_live_ prefix. Keys are generated from account settings and shown in full only once at creation, so they need to be copied immediately. Each key can be scoped to an individual user, a team, or an entire organization, and consumes that scope's own billing account and credit quota.

What file formats and languages does the API support?

The API supports the same 65+ file formats as the Taia web platform, including DOCX, XLSX, JSON, and HTML, and all 204 languages Taia offers. Files are attached when a project is created via POST /projects and downloaded as a ZIP package once translation is complete.

Is API access billed separately, or is it part of a subscription plan?

AI translation through the API is included in the Pro plan (€39/month for 100,000 words) and draws on that plan's existing credit quota — there is no separate API billing or usage limit, and the API is not available on the Free or Basic plans. Professional (human) translation orders placed via the API are billed separately, pay-per-use, at Taia's standard per-word rates: from €0.06/word for Essential, €0.09/word for Enhanced, and €0.12/word for Ultimate.

Is there a rate limit on the Taia API?

Taia has not published a fixed requests-per-second or requests-per-minute limit for the API. [NEEDS DATA: confirm whether a hard rate limit exists] Translation volume is instead capped by your account's monthly word quota — the API draws on the same Pro plan credit quota as the web platform, so high-volume automation is limited by that quota rather than by call frequency.

Does the API support webhooks, or do I have to poll for status?

Both. You can poll the /projects/{id}/status endpoint, or register up to 5 webhooks per API key to receive real-time callbacks for any of 12 event types across the project and order lifecycle, such as project.mt_completed or order.delivered. Webhook deliveries are signed with an HMAC secret and automatically retried on failure, so polling is optional rather than required.

Can I attach translation memory and glossaries to API projects?

Yes. When creating a project via POST /projects, you can optionally attach translation memories and glossaries alongside your files and target languages. This keeps AI-translated output consistent with previously approved terminology and phrasing, the same way translation memory and glossary work on the Taia web platform.

Can I order professional human translation through the API, not just AI?

Yes. Beyond instant AI translation, the API supports requesting a quote, selecting a service tier — Essential, Enhanced, or Ultimate — choosing a delivery date, and placing the order, all programmatically. These orders are fulfilled by Taia's ISO 17100-certified linguists rather than AI alone.

Included in Pro Plan

API access is available exclusively in the Pro plan. Uses your Pro plan credit quota—no separate API billing or usage limits.

View Pro Plan Book a Demo

Not available in Free or Basic plans

Start Automating Translation Today

Integrate Taia's AI translation into your workflow with our REST API. Build once, translate everywhere.

View API Docs See Pricing