JigsawStack icon

JigsawStack

Use JigsawStack API

Actions20

Overview

The "Translate Image" operation of this node allows users to translate the text content within an image from its original language into a specified target language. This is particularly useful for scenarios such as localizing images containing text (e.g., signs, menus, documents) without manually editing the image. For example, a marketing team could automatically translate promotional images for different regions, or a traveler could translate foreign-language street signs captured in photos.

Properties

Name Meaning
Image Source Choose the source of the image: either an Image URL or a File Store Key referencing stored image data.
Image URL The direct URL of the image to be translated (used if Image Source is set to "Image URL").
File Store Key The key identifying the image stored in Jigsawstack File Storage (used if Image Source is "File Store Key").
Target Language The language code representing the desired translation language (e.g., "es" for Spanish).
Return Type The format in which the translated image is returned: Base64 string, URL, or binary data.

Output

The node outputs the translated image in the format specified by the "Return Type" property:

  • Base64: A base64-encoded string representation of the translated image.
  • Url: A URL pointing to the location where the translated image can be accessed.
  • Binary: The raw binary data of the translated image, suitable for further processing or saving.

The output JSON will contain the translated image data accordingly, enabling downstream nodes to consume or store the result.

Dependencies

  • Requires an API key credential for authenticating with the JigsawStack API service.
  • The node communicates with the JigsawStack API endpoint at https://api.jigsawstack.com/v1.
  • If using the "File Store Key" option, the image must already be uploaded and accessible via Jigsawstack File Storage.

Troubleshooting

  • Invalid or missing API key: Ensure that a valid API key credential is configured; otherwise, authentication errors will occur.
  • Incorrect image source: Providing an invalid URL or a non-existent file store key will cause the translation request to fail.
  • Unsupported target language code: Verify that the target language code is supported by the API to avoid errors.
  • Return type mismatches: Selecting a return type incompatible with downstream nodes may cause issues; ensure the chosen format fits your workflow.
  • Network or API errors: Temporary network issues or API downtime can cause failures; retrying or checking service status may help.

Links and References

Discussion