Guides
Changelog

API Changelog

Track all changes, improvements, and new features in the TranslatePlus API. This changelog documents the evolution from API v1 to v2 and all subsequent updates.

Version Overview

API v1 (Legacy)

The initial version of the TranslatePlus API with 3 core endpoints:

  • POST /v1/translate - Translate text
  • POST /v1/language_detect - Detect language
  • GET /v1/supported-languages - Get supported languages

API v2 (Current)

A complete rewrite with enhanced features, improved performance, and expanded capabilities. Includes 10+ endpoints covering translation, batch processing, HTML translation, subtitles, i18n file translation, and account management.

Migrating from v1 to v2

API v1 endpoints remain available for backward compatibility. However, we recommend migrating to v2 for better performance, additional features, and ongoing support.

v1 → v2 Endpoint Mapping

  • POST /v1/translate → POST /v2/translate
  • POST /v1/language_detect → POST /v2/detect_language
  • GET /v1/supported-languages → GET /v2/supported-languages

Key Improvements in v2

  • Standardized error messages across all endpoints
  • Improved response times with async architecture
  • Enhanced error handling with detailed messages
  • Better rate limiting and credit management
  • Comprehensive request logging and analytics

Changelog

Version 2.0.0 - December 9, 2024

🚀 Major Release - API v2 Launch

New Features:

  • Batch Translation: Added POST /v2/translate/batch endpoint for translating up to 100 texts in a single request
  • HTML Translation: Introduced POST /v2/translate/html for translating HTML content while preserving structure and tags
  • Subtitle Translation: Added POST /v2/translate/subtitles supporting SRT and VTT formats with timestamp preservation
  • i18n File Translation: Complete i18n translation system with support for JSON, YAML, PO/POT, Java Properties, and iOS Strings files
  • Account Management: Added GET /v2/account/summary for account information and usage statistics
  • Health Check: Public GET /health endpoint for service monitoring

Improvements:

  • Standardized error messages across all endpoints for consistent error handling
  • Enhanced placeholder extraction and preservation for i18n files
  • Improved response times with asynchronous request processing
  • Better credit management with real-time credit checking and caching
  • Enhanced rate limiting with per-consumer limits and Redis-based tracking
  • Comprehensive request logging with structured logging support

Documentation:

  • Complete API documentation for all v2 endpoints
  • Error handling guide with standardized error messages
  • Rate limits documentation
  • Code examples in multiple languages

Version 2.0.0-beta.3 - December 8, 2024

🔧 i18n Translation Enhancements

New Features:

  • Enhanced placeholder extraction supporting ICU plural/select/selectordinal patterns
  • Improved placeholder preservation for translated placeholder names
  • Support for Markdown reference links and definitions
  • HTML/XML tag placeholder restoration
  • JSX optional chaining support

Bug Fixes:

  • Fixed ICU syntax validation for simple placeholders
  • Improved placeholder restoration logic for complex nested structures
  • Fixed HTML tag placeholder insertion within tag content

Version 2.0.0-beta.2 - December 7, 2024

🌐 i18n Translation System

New Features:

  • Added i18n translation job creation endpoint: POST /v2/translate/i18n
  • Job status tracking: GET /v2/translate/i18n/jobs/{job_id}/status
  • Download translated files: GET /v2/translate/i18n/jobs/{job_id}/download
  • List all jobs: GET /v2/translate/i18n/jobs
  • Delete jobs: DELETE /v2/translate/i18n/jobs/{job_id}
  • Support for multiple file formats: JSON, YAML, PO/POT, Java Properties, iOS Strings
  • Placeholder extraction and preservation for various placeholder types

Version 2.0.0-beta.1 - December 6, 2024

🎯 Core v2 Endpoints

New Features:

  • Launched POST /v2/translate - Enhanced text translation endpoint
  • Launched POST /v2/detect_language - Improved language detection
  • Launched GET /v2/supported-languages - Updated language list endpoint
  • Added GET /v2/account/summary - Account information and usage statistics

Infrastructure:

  • Migrated to FastAPI for improved performance
  • Implemented async/await architecture
  • Added Redis caching for API key validation and credit checks
  • Enhanced error handling with custom exception classes
  • Implemented structured logging with structlog

Version 1.0.0 - Initial Release

🎉 Initial API Release

Features:

  • POST /v1/translate - Text translation between 100+ languages
  • POST /v1/detect - Automatic language detection
  • GET /v1/supported-languages - List of supported languages
  • API key authentication
  • Credit-based usage system
Code Examples