Fine-Tune Image Translation

POST

image-translation

fine-tune

curl --request POST \
  --url https://client.camb.ai/apis/image-translation/fine-tune \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "run_id": null,
  "target_language_id": null,
  "region_id": null,
  "prompt": "Make the text bolder and change the color to a vibrant red"
}
'

import requests

url = "https://client.camb.ai/apis/image-translation/fine-tune"

payload = {
    "run_id": None,
    "target_language_id": None,
    "region_id": None,
    "prompt": "Make the text bolder and change the color to a vibrant red"
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    run_id: null,
    target_language_id: null,
    region_id: null,
    prompt: 'Make the text bolder and change the color to a vibrant red'
  })
};

fetch('https://client.camb.ai/apis/image-translation/fine-tune', 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/fine-tune",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'run_id' => null,
    'target_language_id' => null,
    'region_id' => null,
    'prompt' => 'Make the text bolder and change the color to a vibrant red'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "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;
}

{
  "task_id": "<string>",
  "user_message": {
    "id": 123,
    "role": "<string>",
    "content": "<string>",
    "render_version_id": 123,
    "created_at": "<string>"
  }
}

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

Refining a Single Region

If one piece of text isn’t quite right, whether the translation or the way it looks, you can adjust just that region without re-running the whole image. Send the run_id, the target_language_id of the translation you want to change, the region_id of the text region, and a prompt describing what you want. You can find region IDs in Get Image Translation Project.

Writing a Good Prompt

The prompt is a short, plain-language instruction that applies to the one region you selected. Be specific about what should change, whether that is the wording or how the text looks: its color, font, size, or shadow. A single sentence is usually enough. Examples:

Change the text color to white
Use a bolder, larger font
Add a soft drop shadow behind the text
Make the text color more vibrant
Shorten the translation so it fits the speech balloon

Because each prompt only affects one region, send a separate request for each region you want to adjust.

Applying the Result

The response contains a task_id and a user_message (the prompt as stored on the run). To see the change in your download:

Poll /image-translation/{task_id} until the status is SUCCESS
Call Export Image Translation. A fine-tune doesn’t update your download on its own, so this step is required for the change to appear
Fetch the updated pages from /image-translation/result/{run_id}

Request Example

import os
import requests

headers = {
    "x-api-key": os.environ["CAMB_API_KEY"],
    "Content-Type": "application/json",
}

response = requests.post(
    "https://client.camb.ai/apis/image-translation/fine-tune",
    headers=headers,
    json={
        "run_id": 12345,
        "target_language_id": 54,
        "region_id": 1,
        "prompt": "Use a bolder font and make the text color more vibrant",
    },
)
response.raise_for_status()
print(response.json()["task_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.

Body

application/json

run_id

integer

required

The image translation run that contains the region.

Example:

null

target_language_id

integer

required

Numeric language ID of the translation to edit.

Example:

null

region_id

integer

required

ID of the text region to re-render. Get it from GET /image-translation/project/{run_id}.

Example:

null

prompt

string

required

A short instruction describing how this region's translation should change. Be specific about what should change, either the wording or how the text looks, for example Change the text color to white or Add a soft drop shadow behind the text.

Minimum string length: 1

Example:

"Make the text bolder and change the color to a vibrant red"

Response

Successful Response

task_id

string

required

Poll GET /image-translation/{task_id} until SUCCESS, then export again.

user_message

FineTuneImageTranslationUserMessageOut · object

required

Hide child attributes

user_message.id

integer

required

user_message.role

string

required

user_message.content

string

required

user_message.render_version_id

integer

required

user_message.created_at

string | null

Last modified on November 11, 2026

Fine-Tune Image Translation

curl --request POST \
  --url https://client.camb.ai/apis/image-translation/fine-tune \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "run_id": null,
  "target_language_id": null,
  "region_id": null,
  "prompt": "Make the text bolder and change the color to a vibrant red"
}
'

import requests

url = "https://client.camb.ai/apis/image-translation/fine-tune"

payload = {
    "run_id": None,
    "target_language_id": None,
    "region_id": None,
    "prompt": "Make the text bolder and change the color to a vibrant red"
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    run_id: null,
    target_language_id: null,
    region_id: null,
    prompt: 'Make the text bolder and change the color to a vibrant red'
  })
};

fetch('https://client.camb.ai/apis/image-translation/fine-tune', 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/fine-tune",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'run_id' => null,
    'target_language_id' => null,
    'region_id' => null,
    'prompt' => 'Make the text bolder and change the color to a vibrant red'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "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;
}

{
  "task_id": "<string>",
  "user_message": {
    "id": 123,
    "role": "<string>",
    "content": "<string>",
    "render_version_id": 123,
    "created_at": "<string>"
  }
}

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

Getting Started

Models

Tutorials

SDK Guides

Hosting Platforms

Integrations

API Reference

Other Products

Release Logs

Fine-Tune Image Translation

Refining a Single Region

Writing a Good Prompt

Applying the Result

Request Example

Authorizations

Body

Response

​Refining a Single Region

​Writing a Good Prompt

​Applying the Result

​Request Example

Authorizations

Body

Response

Refining a Single Region

Writing a Good Prompt

Applying the Result

Request Example