Get Image Translation Task Status

GET

image-translation

{task_id}

curl --request GET \
  --url https://client.camb.ai/apis/image-translation/{task_id} \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://client.camb.ai/apis/image-translation/{task_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://client.camb.ai/apis/image-translation/{task_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

{
  "status": "SUCCESS",
  "run_id": 123
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Tracking Image Translation Tasks

Image translation, export, and fine-tune requests all run asynchronously. Pass the task_id returned by POST /image-translation, POST /image-translation/export, or POST /image-translation/fine-tune to check how far along the task is.

Task Statuses

`status`	Meaning
`PENDING`	The task is still running. Poll again.
`SUCCESS`	The task finished. Use the returned `run_id` with the result and project endpoints.
`ERROR`	The task failed. Read `exception_reason` or `message` when present.

A task that was just created may report PENDING briefly before it starts. Treat PENDING as “keep polling”, not as an error.

Request Example

Poll the status endpoint until the task reaches a terminal status:

import os
import time
import requests

headers = {"x-api-key": os.environ["CAMB_API_KEY"]}
task_id = "your_task_id"

while True:
    response = requests.get(
        f"https://client.camb.ai/apis/image-translation/{task_id}",
        headers=headers,
    )
    response.raise_for_status()
    status = response.json()
    print(status["status"])
    if status["status"] in ("SUCCESS", "ERROR"):
        break
    time.sleep(5)

Next Steps

Once the status is SUCCESS, retrieve your translated pages from /image-translation/result/{run_id}, or inspect individual text regions with /image-translation/project/{run_id}.

Authorizations

x-api-key

string

header

required

The x-api-key is a custom header required for authenticating requests to our API. Include this header in your request with the appropriate API key value to securely access our endpoints. You can find your API key(s) in the 'API' section of our studio website.

Path Parameters

task_id

string

required

Task ID returned by create, export, or fine-tune.

Response

Successful Response

status

enum<string>

Available options:

SUCCESS,

PENDING,

TIMEOUT,

ERROR,

PAYMENT_REQUIRED

run_id

integer | null

Last modified on November 11, 2026

Get Image Translation Task Status

curl --request GET \
  --url https://client.camb.ai/apis/image-translation/{task_id} \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://client.camb.ai/apis/image-translation/{task_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://client.camb.ai/apis/image-translation/{task_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

{
  "status": "SUCCESS",
  "run_id": 123
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Getting Started

Models

Tutorials

SDK Guides

Hosting Platforms

Integrations

API Reference

Other Products

Release Logs

Get Image Translation Task Status

Tracking Image Translation Tasks

Task Statuses

Request Example

Next Steps

Authorizations

Path Parameters

Response

​Tracking Image Translation Tasks

​Task Statuses

​Request Example

​Next Steps

Authorizations

Path Parameters

Response

Tracking Image Translation Tasks

Task Statuses

Request Example

Next Steps