POST
/
v1
/
ai
/
translate
/
image
import { JigsawStack } from "jigsawstack";

const jigsaw = JigsawStack({ apiKey: "your-api-key" });

const response = await jigsaw.translate.image({
  "url": "https://images.unsplash.com/photo-1528716321680-815a8cdb8cbe?q=80&w=1376&auto=format&fit=crop&ixlib=rb-4.1.0&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D",
  "target_language": "hi",
  "return_type": "url"
})

{
  "url": "https://jigsawstack-temp.b1e91a466694ad4af04df5d05ca12d93.r2.cloudflarestorage.com/temp/f4df31f2-c5d7-4ad1-9ade-89b48fd0adea.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=7b9a19349842b7b1a9e4c2e19f05b232%2F20250826%2Fauto%2Fs3%2Faws4_request&X-Amz-Date=20250826T233032Z&X-Amz-Expires=604800&X-Amz-Signature=d73271d461fee9d8f22f415036922b9af6cf6f6c06e7e86be98e37350be01ab3&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject",
  "_usage": {
        "input_tokens": 56,
        "output_tokens": 186,
        "inference_time_tokens": 31410,
        "total_tokens": 31652
  }
}

​
Request Parameters

​
Body

​
url
string
The URL of the image containing text to translate. If provided, the image will be downloaded from this URL. Must be a valid URL. Either url or file_store_key must be provided.
​
file_store_key
string
The file store key of a previously uploaded image. Either url or file_store_key must be provided.
​
target_language
string
required
The language code of the target language to translate to. All supported language codes can be found here.
​
return_type
string
The specified return type for the response
  • url
  • base64
  • binary

​
Response Structure

​
success
boolean
Indicates whether the call was successful.
​
translated_text
string
The translated text content extracted from the image.
import { JigsawStack } from "jigsawstack";

const jigsaw = JigsawStack({ apiKey: "your-api-key" });

const response = await jigsaw.translate.image({
  "url": "https://images.unsplash.com/photo-1528716321680-815a8cdb8cbe?q=80&w=1376&auto=format&fit=crop&ixlib=rb-4.1.0&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D",
  "target_language": "hi",
  "return_type": "url"
})

{
  "url": "https://jigsawstack-temp.b1e91a466694ad4af04df5d05ca12d93.r2.cloudflarestorage.com/temp/f4df31f2-c5d7-4ad1-9ade-89b48fd0adea.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=7b9a19349842b7b1a9e4c2e19f05b232%2F20250826%2Fauto%2Fs3%2Faws4_request&X-Amz-Date=20250826T233032Z&X-Amz-Expires=604800&X-Amz-Signature=d73271d461fee9d8f22f415036922b9af6cf6f6c06e7e86be98e37350be01ab3&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject",
  "_usage": {
        "input_tokens": 56,
        "output_tokens": 186,
        "inference_time_tokens": 31410,
        "total_tokens": 31652
  }
}