Skip to content

Get Translation Status

GET
/translation/{task_id}
curl --request GET \
--url https://example.com/translation/example \
--header 'Authorization: Bearer <token>'

Check the status of an async translation task (batch or single).

Returns:

  • status=“pending”: Task is queued but not started
  • status=“started”: Task is currently processing (warmup or translation)
  • status=“completed”: Task finished successfully, results are available
  • status=“failed”: Task failed, error contains details
task_id
required
Task Id
string

Successful Response

Media typeapplication/json
TranslationStatus
object
task_id
required
Task Id

Celery task ID

string
status
required
Status

Task status: pending, started, completed, failed

string
translations
Any of:
Array<object>
object
key
additional properties
any
translation
Any of:
string
successful_items
Any of:
integer
failed_items
Any of:
integer
error
Any of:
string
pivot_used
Any of:
boolean
pivot_lang
Any of:
string
pivot_text
Any of:
string
stage1_cache_hit
Any of:
boolean
provider
Any of:
string
usage
Any of:
TokenUsage
object
prompt_tokens
Any of:
integer
completion_tokens
Any of:
integer
total_tokens
Any of:
integer
quantization
Any of:
string
gpu_mem_allocated_gb
Any of:
number
gpu_mem_reserved_gb
Any of:
number
processing_time_ms
Any of:
number
translation_job_uuid
Any of:
string
model_info
Any of:
object
key
additional properties
any
effective_params
Any of:
object
key
additional properties
any
Examplegenerated
{
"task_id": "example",
"status": "example",
"translations": [
{}
],
"translation": "example",
"successful_items": 1,
"failed_items": 1,
"error": "example",
"pivot_used": true,
"pivot_lang": "example",
"pivot_text": "example",
"stage1_cache_hit": true,
"provider": "example",
"usage": {
"prompt_tokens": 1,
"completion_tokens": 1,
"total_tokens": 1,
"quantization": "example",
"gpu_mem_allocated_gb": 1,
"gpu_mem_reserved_gb": 1
},
"processing_time_ms": 1,
"translation_job_uuid": "example",
"model_info": {},
"effective_params": {}
}

Validation Error

Media typeapplication/json
HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
input
Input
ctx
Context
object
Examplegenerated
{
"detail": [
{
"loc": [
"example"
],
"msg": "example",
"type": "example",
"input": "example",
"ctx": {}
}
]
}