GET
/translate/file/async
Requires Auth
Translate file (Asynchronous)
Starts an asynchronous translation job. Returns immediately with job_id. Use this for large files (> 10MB) or when you need non-blocking processing.
Parameters
file
*
query
string
URL of the file to translate (must be publicly accessible)
Example:
https://example.com/large-document.pdf
target
query
string
Target language code (ISO 639-1). Default: en
Example:
ar
bilingual
query
string
Enable bilingual mode. When true, original text is kept and translation is added below it.
Example:
false
Allowed Values:
true
false
Code Examples
curl -X GET \
-H 'Authorization: Bearer YOUR_API_TOKEN' \
-H 'Content-Type: application/json' \
'https://nexus-api.dhurgham.dev/api/file-translation-api/translate/file/async?file=https%3A%2F%2Fexample.com%2Flarge-document.pdf&target=ar&bilingual=false'
Example cURL Request
curl -X GET \
-H 'Authorization: Bearer YOUR_API_TOKEN' \
'https://nexus-api.dhurgham.dev/api/file-translation-api/translate/file/async?file=https%3A%2F%2Fexample.com%2Flarge-document.pdf&target=ar&bilingual=false'
frontend.example_response
{
"success": true,
"job_id": "a1b2c3d4",
"status_url": "https://nexus-api.dhurgham.dev/api/file-translation-api/translate/status/a1b2c3d4",
"message": "Translation job started"
}