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.

Test Endpoint

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"
}