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
23/05/2026, 21:16:05	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.

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