{"openapi":"3.1.0","info":{"title":"TranslatePlus API","description":"Enterprise-grade translation API supporting 100+ languages, engineered for high performance, reliability, and scalable integration.","version":"2.0.0"},"servers":[{"url":"https://api.translateplus.io","description":"Production"}],"paths":{"/v2/translate":{"post":{"tags":["Translation"],"summary":"Translate text","description":"Translate text from source language to target language","operationId":"translate_v2_translate_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TranslateRequest"}}},"required":true},"responses":{"200":{"description":"Translation successful","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TranslateResponse"},"example":{"translations":{"text":"My client speaks only French. Will you translate for me?","translation":"Mon client ne parle que le français. Voulez-vous traduire pour moi ?","source":"en","target":"fr"},"details":{}}}}},"400":{"description":"Invalid request"},"402":{"description":"Insufficient credits"},"403":{"description":"Invalid API key"},"429":{"description":"Rate limit exceeded"},"503":{"description":"Translation service unavailable"},"500":{"description":"Internal server error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v2/translate/batch":{"post":{"tags":["Translation"],"summary":"Batch translate texts","description":"Translate multiple texts in a single request (up to 100 texts)","operationId":"batch_translate_v2_translate_batch_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchTranslateRequest"}}},"required":true},"responses":{"200":{"description":"Batch translation successful","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchTranslateResponse"},"example":{"translations":[{"text":"Hello, how are you?","translation":"Bonjour, comment allez-vous ?","source":"en","target":"fr","success":true},{"text":"What is your name?","translation":"Quel est votre nom ?","source":"en","target":"fr","success":true}],"total":2,"successful":2,"failed":0}}}},"400":{"description":"Invalid request"},"402":{"description":"Insufficient credits"},"403":{"description":"Invalid API key"},"429":{"description":"Rate limit exceeded"},"503":{"description":"Translation service unavailable"},"500":{"description":"Internal server error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v2/translate/html":{"post":{"tags":["Translation"],"summary":"Translate HTML","description":"Safely translate HTML content while preserving all tags and structure","operationId":"translate_html_v2_translate_html_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TranslateHtmlRequest"}}},"required":true},"responses":{"200":{"description":"HTML translation successful","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TranslateHtmlResponse"},"example":{"html":"<p>مرحبا <b>بالعالم</b></p>"}}}},"400":{"description":"Invalid request"},"402":{"description":"Insufficient credits"},"403":{"description":"Invalid API key"},"429":{"description":"Rate limit exceeded"},"503":{"description":"Translation service unavailable"},"500":{"description":"Internal server error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v2/translate/email":{"post":{"tags":["Translation"],"summary":"Translate email","description":"Translate email subject and HTML body while preserving HTML structure","operationId":"translate_email_v2_translate_email_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TranslateEmailRequest"}}},"required":true},"responses":{"200":{"description":"Email translation successful","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TranslateEmailResponse"},"example":{"subject":"Bienvenue dans notre service","html_body":"<p>Merci de vous être inscrit!</p><p>Nous sommes ravis de vous avoir.</p>"}}}},"400":{"description":"Invalid request"},"402":{"description":"Insufficient credits"},"403":{"description":"Invalid API key"},"429":{"description":"Rate limit exceeded"},"503":{"description":"Translation service unavailable"},"500":{"description":"Internal server error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v2/translate/subtitles":{"post":{"tags":["Translation"],"summary":"Translate subtitles","description":"Translate SRT or VTT subtitle files while preserving timestamps","operationId":"translate_subtitles_v2_translate_subtitles_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TranslateSubtitleRequest"}}},"required":true},"responses":{"200":{"description":"Subtitle translation successful","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TranslateSubtitleResponse"},"example":{"format":"srt","content":"1\n00:00:01,000 --> 00:00:02,000\nHola mundo\n"}}}},"400":{"description":"Invalid request"},"402":{"description":"Insufficient credits"},"403":{"description":"Invalid API key"},"429":{"description":"Rate limit exceeded"},"503":{"description":"Translation service unavailable"},"500":{"description":"Internal server error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v2/language_detect":{"post":{"tags":["Language"],"summary":"Detect language","description":"Detect the language of the provided text","operationId":"detect_language_v2_language_detect_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DetectLanguageRequest"}}},"required":true},"responses":{"200":{"description":"Language detection successful","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DetectLanguageResponse"},"example":{"language_detection":{"text":"My client speaks only French.","language":"en"}}}}},"400":{"description":"Invalid request"},"403":{"description":"Invalid API key"},"429":{"description":"Rate limit exceeded"},"503":{"description":"Language detection service unavailable"},"500":{"description":"Internal server error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v2/supported-languages":{"get":{"tags":["Language"],"summary":"Supported Languages","description":"Get list of all supported languages with their codes","operationId":"supported_languages_v2_supported_languages_get","responses":{"200":{"description":"List of supported languages","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SupportedLanguagesResponse"},"example":{"supported_languages":{"Auto Detect":"auto","English":"en","French":"fr","Spanish":"es","German":"de","Chinese (Simplified)":"zh-CN","Arabic":"ar"}}}}},"401":{"description":"Invalid or missing API key"},"403":{"description":"Invalid API key"}},"security":[{"APIKeyHeader":[]}]}},"/v2/account/summary":{"get":{"tags":["Account Summary"],"summary":"Get account summary","description":"Get account summary including credits, subscription, and usage statistics","operationId":"get_account_summary_v2_account_summary_get","responses":{"200":{"description":"User details retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserDetailsResponse"},"example":{"email":"user@example.com","full_name":"John Doe","total_credits":1000,"credits_used":250,"credits_remaining":750,"credits_percentage":25.0,"summary":{"total_requests":1000,"successful_requests":950,"failed_requests":50,"success_rate":95.0}}}}},"401":{"description":"Invalid API key"},"500":{"description":"Internal server error"}},"security":[{"APIKeyHeader":[]}]}},"/v2/translate/i18n":{"post":{"tags":["Internationalization (i18n)"],"summary":"Create i18n translation job","description":"Upload an i18n file (JSON, YAML, PO, etc.) and translate it to multiple target languages","operationId":"create_i18n_translation_job_v2_translate_i18n_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_create_i18n_translation_job_v2_translate_i18n_post"}}},"required":true},"responses":{"201":{"description":"Job created successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/I18nJobResponse"},"example":{"job_id":"550e8400-e29b-41d4-a716-446655440000","status":"pending","message":"Translation job created successfully"}}}},"400":{"description":"Invalid request"},"402":{"description":"Insufficient credits"},"403":{"description":"Invalid API key"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Internal server error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v2/translate/i18n/jobs/{job_id}/status":{"get":{"tags":["Internationalization (i18n)"],"summary":"Get i18n job status","description":"Get the status and details of an i18n translation job","operationId":"get_i18n_job_status_v2_translate_i18n_jobs__job_id__status_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}}],"responses":{"200":{"description":"Job status retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/I18nJobStatusResponse"}}}},"404":{"description":"Job not found"},"403":{"description":"Invalid API key"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/translate/i18n/jobs/{job_id}/download":{"get":{"tags":["Internationalization (i18n)"],"summary":"Download translated file","description":"Download a translated i18n file for a specific language. This endpoint requires authentication.","operationId":"download_i18n_file_v2_translate_i18n_jobs__job_id__download_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}},{"name":"language_code","in":"query","required":true,"schema":{"type":"string","description":"Target language code","title":"Language Code"},"description":"Target language code"}],"responses":{"200":{"description":"File downloaded successfully","content":{"application/json":{"schema":{}},"application/octet-stream":{}}},"404":{"detail":"Translated file for language fr not found","description":"Not Found"},"401":{"description":"Unauthorized / Invalid API Key"},"403":{"description":"Forbidden / Invalid API Key"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/translate/i18n/jobs/{job_id}":{"delete":{"tags":["Internationalization (i18n)"],"summary":"Delete i18n job","description":"Delete an i18n translation job and all its associated files","operationId":"delete_i18n_job_v2_translate_i18n_jobs__job_id__delete","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}}],"responses":{"200":{"description":"Job deleted successfully","content":{"application/json":{"schema":{}}}},"404":{"description":"Job not found"},"403":{"description":"Invalid API key"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/translate/i18n/jobs":{"get":{"tags":["Internationalization (i18n)"],"summary":"List i18n jobs","description":"List all i18n translation jobs for the authenticated user","operationId":"list_i18n_jobs_v2_translate_i18n_jobs_get","responses":{"200":{"description":"Jobs retrieved successfully","content":{"application/json":{"schema":{}}}},"403":{"description":"Invalid API key"}},"security":[{"APIKeyHeader":[]}]}},"/v1/translate":{"post":{"tags":["Legacy API (V1)"],"summary":"Translate text (v1)","description":"Translate text from source language to target language (v1 API)","operationId":"v1_translate_v1_translate_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TranslateRequest"}}},"required":true},"responses":{"200":{"description":"Translation successful","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TranslateResponse"},"example":{"translations":{"text":"My client speaks only French. Will you translate for me?","translation":"Mon client ne parle que le français. Voulez-vous traduire pour moi ?","source":"en","target":"fr"},"details":{}}}}},"400":{"description":"Invalid request"},"402":{"description":"Insufficient credits"},"403":{"description":"Invalid API key"},"429":{"description":"Rate limit exceeded"},"503":{"description":"Translation service unavailable"},"500":{"description":"Internal server error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/language_detect":{"post":{"tags":["Legacy API (V1)"],"summary":"Detect language (v1)","description":"Detect the language of the provided text (v1 API)","operationId":"v1_detect_v1_language_detect_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DetectLanguageRequest"}}},"required":true},"responses":{"200":{"description":"Language detection successful","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DetectLanguageResponse"},"example":{"language_detection":{"text":"My client speaks only French.","language":"en"}}}}},"400":{"description":"Invalid request"},"403":{"description":"Invalid API key"},"429":{"description":"Rate limit exceeded"},"503":{"description":"Language detection service unavailable"},"500":{"description":"Internal server error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/supported-languages":{"get":{"tags":["Legacy API (V1)"],"summary":"Get supported languages (v1)","description":"Get dictionary of all supported languages with their codes (v1 API)","operationId":"v1_supported_languages_v1_supported_languages_get","responses":{"200":{"description":"Dictionary of supported languages","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SupportedLanguagesResponse"},"example":{"supported_languages":{"Auto Detect":"auto","English":"en","French":"fr","Spanish":"es"}}}}},"401":{"description":"Invalid or missing API key"},"403":{"description":"Invalid API key"}},"security":[{"APIKeyHeader":[]}]}},"/health":{"get":{"tags":["Account Summary"],"summary":"Health Check","description":"Health check endpoint.\n\nLightweight health check that returns quickly.\nRedis check is done with timeout to prevent blocking under load.\n\nReturns:\n    - 200 OK with status \"ok\": Service is operational\n    - 503 Service Unavailable with status \"error\": Service is down","operationId":"health_check_health_get","responses":{"200":{"description":"Service is operational","content":{"application/json":{"schema":{},"example":{"status":"ok","service":"translateplus-api","version":"2.0.0","redis":"ok"}}}},"503":{"description":"Service is unavailable","content":{"application/json":{"example":{"status":"error","service":"translateplus-api","version":"2.0.0"}}}}}}}},"components":{"schemas":{"BatchTranslateRequest":{"properties":{"texts":{"items":{"type":"string"},"type":"array","maxItems":100,"minItems":1,"title":"Texts","description":"List of texts to translate (1-100 texts per request)"},"source":{"type":"string","title":"Source","description":"Source language code (e.g., 'en', 'fr', 'auto' for auto-detect)"},"target":{"type":"string","title":"Target","description":"Target language code (e.g., 'en', 'fr')"}},"type":"object","required":["texts","source","target"],"title":"BatchTranslateRequest","description":"Batch translation request model.","example":{"source":"en","target":"fr","texts":["Hello, how are you?","What is your name?","Thank you very much"]}},"BatchTranslateResponse":{"properties":{"translations":{"items":{"type":"object"},"type":"array","title":"Translations","description":"List of translation results, one for each input text"},"total":{"type":"integer","title":"Total","description":"Total number of translations"},"successful":{"type":"integer","title":"Successful","description":"Number of successful translations"},"failed":{"type":"integer","title":"Failed","description":"Number of failed translations"}},"type":"object","required":["translations","total","successful","failed"],"title":"BatchTranslateResponse","description":"Batch translation response model."},"Body_create_i18n_translation_job_v2_translate_i18n_post":{"properties":{"file":{"type":"string","format":"binary","title":"File","description":"i18n file to translate (JSON, YAML, PO, etc.)"},"source_language":{"type":"string","title":"Source Language","description":"Source language code (or 'auto' for auto-detection)","default":"auto"},"target_languages":{"type":"string","title":"Target Languages","description":"Comma-separated list of target language codes (e.g., 'fr,es,de')"},"webhook_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Webhook Url","description":"Optional webhook URL to receive notification when job completes"}},"type":"object","required":["file","target_languages"],"title":"Body_create_i18n_translation_job_v2_translate_i18n_post"},"DetectLanguageRequest":{"properties":{"text":{"type":"string","maxLength":5000,"minLength":1,"title":"Text","description":"Text to detect language from (max 5000 characters)"}},"type":"object","required":["text"],"title":"DetectLanguageRequest","description":"Language detection request model.","example":{"text":"My client speaks only French."}},"DetectLanguageResponse":{"properties":{"language_detection":{"type":"object","title":"Language Detection","description":"Detected language information"}},"type":"object","required":["language_detection"],"title":"DetectLanguageResponse","description":"Language detection response model."},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"I18nJobResponse":{"properties":{"job_id":{"type":"string","title":"Job Id","description":"Unique job identifier"},"status":{"type":"string","title":"Status","description":"Job status (pending, processing, completed, failed)"},"message":{"type":"string","title":"Message","description":"Status message"}},"type":"object","required":["job_id","status","message"],"title":"I18nJobResponse","description":"Response model for i18n job creation."},"I18nJobStatusResponse":{"properties":{"id":{"type":"string","title":"Id","description":"Job ID"},"job_id":{"type":"string","title":"Job Id","description":"Unique job identifier"},"status":{"type":"string","title":"Status","description":"Job status"},"original_filename":{"type":"string","title":"Original Filename","description":"Original uploaded filename"},"file_type":{"type":"string","title":"File Type","description":"File type (json, yaml, po, etc.)"},"source_language":{"type":"string","title":"Source Language","description":"Source language code"},"target_languages":{"items":{"type":"string"},"type":"array","title":"Target Languages","description":"List of target language codes"},"total_keys":{"type":"integer","title":"Total Keys","description":"Total number of translation keys"},"translated_keys":{"type":"integer","title":"Translated Keys","description":"Number of successfully translated keys"},"failed_keys":{"type":"integer","title":"Failed Keys","description":"Number of failed translation keys"},"error_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Message","description":"Error message if job failed"},"created_at":{"type":"string","title":"Created At","description":"Job creation timestamp"},"updated_at":{"type":"string","title":"Updated At","description":"Job last update timestamp"},"completed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Completed At","description":"Job completion timestamp"},"translated_files":{"items":{"type":"object"},"type":"array","title":"Translated Files","description":"List of translated files with download URLs"}},"type":"object","required":["id","job_id","status","original_filename","file_type","source_language","target_languages","total_keys","translated_keys","failed_keys","created_at","updated_at"],"title":"I18nJobStatusResponse","description":"Response model for i18n job status."},"SupportedLanguagesResponse":{"properties":{"supported_languages":{"additionalProperties":{"type":"string"},"type":"object","title":"Supported Languages","description":"Dictionary of language names to language codes"}},"type":"object","required":["supported_languages"],"title":"SupportedLanguagesResponse","description":"Supported languages response model."},"TranslateEmailRequest":{"properties":{"subject":{"type":"string","maxLength":5000,"minLength":1,"title":"Subject","description":"Email subject line to translate (max 5000 characters)"},"email_body":{"type":"string","maxLength":200000,"minLength":1,"title":"Email Body","description":"Email body HTML content to translate (max 200000 characters)"},"source":{"type":"string","title":"Source","description":"Source language code (e.g., 'en', 'fr', 'auto' for auto-detect)"},"target":{"type":"string","title":"Target","description":"Target language code (e.g., 'en', 'fr')"}},"type":"object","required":["subject","email_body","source","target"],"title":"TranslateEmailRequest","description":"Email translation request model.","example":{"email_body":"<p>Thank you for signing up!</p><p>We're excited to have you.</p>","source":"en","subject":"Welcome to our service","target":"fr"}},"TranslateEmailResponse":{"properties":{"subject":{"type":"string","title":"Subject","description":"Translated email subject"},"html_body":{"type":"string","title":"Html Body","description":"Translated email body HTML content with tags preserved"}},"type":"object","required":["subject","html_body"],"title":"TranslateEmailResponse","description":"Email translation response model."},"TranslateHtmlRequest":{"properties":{"html":{"type":"string","maxLength":200000,"minLength":1,"title":"Html","description":"HTML content to translate (max 200000 characters)"},"source":{"type":"string","title":"Source","description":"Source language code (e.g., 'en', 'fr', 'auto' for auto-detect)"},"target":{"type":"string","title":"Target","description":"Target language code (e.g., 'en', 'fr')"}},"type":"object","required":["html","source","target"],"title":"TranslateHtmlRequest","description":"HTML translation request model.","example":{"html":"<p>Hello <b>world</b></p>","source":"en","target":"ar"}},"TranslateHtmlResponse":{"properties":{"html":{"type":"string","title":"Html","description":"Translated HTML content with tags preserved"}},"type":"object","required":["html"],"title":"TranslateHtmlResponse","description":"HTML translation response model."},"TranslateRequest":{"properties":{"text":{"type":"string","maxLength":5000,"minLength":1,"title":"Text","description":"Text to translate (single word or paragraph, max 5000 characters)"},"source":{"type":"string","title":"Source","description":"Source language code (e.g., 'en', 'fr', 'auto' for auto-detect)"},"target":{"type":"string","title":"Target","description":"Target language code (e.g., 'en', 'fr')"}},"type":"object","required":["text","source","target"],"title":"TranslateRequest","description":"Translation request model.","example":{"source":"en","target":"fr","text":"My client speaks only French. Will you translate for me?"}},"TranslateResponse":{"properties":{"translations":{"type":"object","title":"Translations","description":"Translation result with text, translation, source, and target"},"details":{"anyOf":[{"type":"object"},{"type":"null"}],"title":"Details","description":"Additional details like definitions, synonyms, examples"}},"type":"object","required":["translations"],"title":"TranslateResponse","description":"Translation response model."},"TranslateSubtitleRequest":{"properties":{"format":{"type":"string","title":"Format","description":"Subtitle format: 'srt' or 'vtt'"},"content":{"type":"string","minLength":1,"title":"Content","description":"Subtitle file content (SRT or VTT format)"},"source":{"type":"string","title":"Source","description":"Source language code (e.g., 'en', 'fr', 'auto' for auto-detect)"},"target":{"type":"string","title":"Target","description":"Target language code (e.g., 'en', 'fr')"}},"type":"object","required":["format","content","source","target"],"title":"TranslateSubtitleRequest","description":"Subtitle translation request model.","example":{"content":"1\n00:00:01,000 --> 00:00:02,000\nHello world\n","format":"srt","source":"en","target":"es"}},"TranslateSubtitleResponse":{"properties":{"format":{"type":"string","title":"Format","description":"Subtitle format: 'srt' or 'vtt'"},"content":{"type":"string","title":"Content","description":"Translated subtitle file content"}},"type":"object","required":["format","content"],"title":"TranslateSubtitleResponse","description":"Subtitle translation response model.","example":{"content":"1\n00:00:01,000 --> 00:00:02,000\nHola mundo\n","format":"srt"}},"UserDetailsResponse":{"properties":{"email":{"type":"string","title":"Email"},"full_name":{"type":"string","title":"Full Name"},"total_credits":{"type":"integer","title":"Total Credits"},"credits_used":{"type":"integer","title":"Credits Used"},"credits_remaining":{"type":"integer","title":"Credits Remaining"},"credits_percentage":{"type":"number","title":"Credits Percentage"},"concurrency":{"type":"integer","title":"Concurrency","default":0},"effective_concurrency":{"type":"integer","title":"Effective Concurrency","default":5},"summary":{"anyOf":[{"$ref":"#/components/schemas/UserSummary"},{"type":"null"}]}},"type":"object","required":["email","full_name","total_credits","credits_used","credits_remaining","credits_percentage"],"title":"UserDetailsResponse","description":"User details response."},"UserSummary":{"properties":{"total_requests":{"type":"integer","title":"Total Requests","default":0},"successful_requests":{"type":"integer","title":"Successful Requests","default":0},"failed_requests":{"type":"integer","title":"Failed Requests","default":0},"success_rate":{"type":"number","title":"Success Rate","default":0.0}},"type":"object","title":"UserSummary","description":"User summary statistics."},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}},"securitySchemes":{"APIKeyHeader":{"type":"apiKey","in":"header","name":"X-API-KEY"}}},"tags":[{"name":"Translation","description":"Translate text, HTML, emails, subtitles, and batches across multiple languages with ease. Designed for fast, accurate, and scalable translations."},{"name":"Language","description":"Detect languages and explore the full list of supported languages with their codes."},{"name":"Internationalization (i18n)","description":"Upload and translate i18n files (JSON, YAML, PO/POT, Properties, XML) into multiple languages. Perfect for automating your localization workflow."},{"name":"Legacy API (V1)","description":"Older v1 endpoints kept for backward compatibility. We recommend using the latest v2 endpoints for better performance and features."},{"name":"Account Summary","description":"View your account details, usage statistics, and credits. Also includes health check endpoints to monitor API status."}]}