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
* required
(query)
string
query
URL of the file to translate (must be publicly accessible)
target
(query)
string
query
Target language code (ISO 639-1). Default: en
bilingual
(query)
string
query
Enable bilingual mode. When true, original text is kept and translation is added below it.
Code Examples
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'
Request Information
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'
Request Schema
Query Parameters
-
filestring required query - URL of the file to translate (must be publicly accessible)
-
Example:
https://example.com/large-document.pdf -
targetstring Optional query - Target language code (ISO 639-1). Default: en
-
Default:
en -
Example:
ar -
bilingualstring Optional query - Enable bilingual mode. When true, original text is kept and translation is added below it.
-
Default:
false -
Example:
false -
Allowed values:
true, false
Responses
200
Success
{
"success": true,
"job_id": "a1b2c3d4",
"status_url": "https://nexus-api.dhurgham.dev/api/file-translation-api/translate/status/a1b2c3d4",
"message": "Translation job started"
}
Response Schema
-
successboolean -
Example:
1 -
job_idstring - Unique job identifier
-
Example:
a1b2c3d4 -
status_urlstring - URL to check job status
-
Example:
https://nexus-api.dhurgham.dev/api/file-translation-api/translate/status/a1b2c3d4 -
messagestring -
Example:
Translation job started
Subscription Plans
Basic
Basic plan
$5,000.00/month
- 1,000 requests/month
- 100 requests/hour
- 20 requests/minute