Skip to main content
POST
Export Image Translation

Exporting Translated Pages

A run is exported automatically when image translation completes. Call this endpoint when you want to refresh the download, for example after a fine-tune, to switch formats, or if GET /image-translation/result/{run_id} returns 404. Send the run_id and, optionally, an export_format:
  • ZIP (default): the translated page images.
  • PDF: one PDF per target language.
The download is always delivered as a ZIP.

Response

The response contains a task_id and a cached flag:

Request Example

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 to export.

Example:

null

export_format
enum<string>
default:ZIP

ZIP (default) is a ZIP of page images. PDF is a ZIP of per-language PDFs. The download is always a ZIP.

Available options:
ZIP,
PDF

Response

Successful Response

task_id
string | null

Poll this task unless cached is true and no new export was queued.

cached
boolean
default:false

True when an existing export artifact was reused and polling can be skipped.

Last modified on November 11, 2026