Concepts

How projects, translatables, translations, translation jobs and billable words fit together.

Project

A translation project. Each project has a source locale, one or more target locales, and contains all the translatable strings and their translations. Projects are the top-level organizational unit — typically one per app or repository.

Translatable

A source string registered for translation. Each translatable has an id (unique within the project), a locale (source language), text (the source string), and an optional description that provides context for the AI translator.

Translation

The generated output for a translatable in a specific target locale. Translations are produced by AI translation jobs and can be retrieved individually or in bulk per project.

Translation Job

A processing task that translates a source string into a target locale using Amazon Bedrock. Jobs progress through these states:

State	Description
`QUEUED`	Job is waiting to be picked up by a worker.
`IN_PROGRESS`	Job is currently being processed.
`DONE`	Translation completed successfully.
`FAILED`	Translation failed. Can be retried.
`BLOCKED`	Job is blocked due to insufficient billing credits.

Billable Words

Usage is calculated as:
billable_words = source_word_count × number_of_target_locales

Only changed strings are re-translated. If you update 10 strings and have 5 target locales, you are billed for the word count of those 10 strings × 5.