diff --git a/docs/en-US/cli/guides/managing-translations.mdx b/docs/en-US/cli/guides/managing-translations.mdx index 8a62fd4a1..a3fa9127e 100644 --- a/docs/en-US/cli/guides/managing-translations.mdx +++ b/docs/en-US/cli/guides/managing-translations.mdx @@ -55,7 +55,7 @@ If your Project uses human review, use [`gt stage`](/docs/cli/reference/commands npx gt stage ``` -Running [`stage`](/docs/cli/reference/commands/stage) sets `stageTranslations: true` in your `gt.config.json`. After translations are approved, run [`gt download`](/docs/cli/reference/commands/download). [`gt translate`](/docs/cli/reference/commands/translate) can also download a previously staged version. While `stageTranslations` is enabled, [`translate`](/docs/cli/reference/commands/translate) only downloads versions you have staged; if nothing has been staged, it exits with an error. +Running [`stage`](/docs/cli/reference/commands/stage) sets `stageTranslations: true` in your `gt.config.json`. After translations are approved, run [`gt download`](/docs/cli/reference/commands/download). [`gt translate`](/docs/cli/reference/commands/translate) can also download previously staged versions. While `stageTranslations` is enabled, [`translate`](/docs/cli/reference/commands/translate) only downloads versions you have staged. If nothing is staged, it completes without downloading files. ## Save local edits [#save-local] diff --git a/docs/en-US/cli/reference/commands/stage.mdx b/docs/en-US/cli/reference/commands/stage.mdx index afae97ee9..bcee54aa8 100644 --- a/docs/en-US/cli/reference/commands/stage.mdx +++ b/docs/en-US/cli/reference/commands/stage.mdx @@ -7,7 +7,7 @@ description: Submit a project for asynchronous translation and later download. A Submits your project for asynchronous translation without downloading or publishing the results in the same run. Use it when your Project has human review enabled or when a format such as Lottie cannot finish in a single [`gt translate`](/docs/cli/reference/commands/translate) run. For both workflows, see [Manage translations](/docs/cli/guides/managing-translations). -Running `stage` sets `stageTranslations: true` in your `gt.config.json`. Once enabled, running [`gt translate`](/docs/cli/reference/commands/translate) without first staging a given version causes the CLI to exit with an error. When translations are ready—and approved when review is required—run [`gt download`](/docs/cli/reference/commands/download). [`gt translate`](/docs/cli/reference/commands/translate) can also download a previously staged version. +Running `stage` sets `stageTranslations: true` in your `gt.config.json`. Once enabled, [`gt translate`](/docs/cli/reference/commands/translate) only downloads staged versions. If nothing is staged, it completes without downloading files. When translations are ready—and approved when review is required—run [`gt download`](/docs/cli/reference/commands/download). [`gt translate`](/docs/cli/reference/commands/translate) can also download previously staged versions. *Note: For production use only. Requires a production `GT_API_KEY` and `GT_PROJECT_ID`.* @@ -21,7 +21,7 @@ npx gt stage 2. Sends the content to the General Translation API without downloading or publishing results in the same run. Review-gated Projects hold completed translations for approval. 3. Sets `stageTranslations: true` in your `gt.config.json` so future runs require staging. -Once `stageTranslations` is enabled, running [`translate`](/docs/cli/reference/commands/translate) without first staging that version causes the CLI to exit with an error. Download completed translations with [`gt download`](/docs/cli/reference/commands/download), or use [`gt translate`](/docs/cli/reference/commands/translate) for any previously staged version. +Once `stageTranslations` is enabled, [`translate`](/docs/cli/reference/commands/translate) only downloads staged versions. With no staged versions, it completes without downloading files. Download completed translations with [`gt download`](/docs/cli/reference/commands/download), or use [`gt translate`](/docs/cli/reference/commands/translate). ## Flags [#flags] diff --git a/docs/en-US/platform/dashboard/guides/managing-billing.mdx b/docs/en-US/platform/dashboard/guides/managing-billing.mdx index 9868bc387..577b7fc39 100644 --- a/docs/en-US/platform/dashboard/guides/managing-billing.mdx +++ b/docs/en-US/platform/dashboard/guides/managing-billing.mdx @@ -22,7 +22,7 @@ Start for free. Add a payment method to turn on usage-based billing: - **Starter — $0/month.** For individuals and small teams. There is no monthly fee; you pay only for what you use. Includes unlimited users, projects, and languages, plus the [Translation Editor](/docs/platform/dashboard/guides/reviewing-translations), GitHub integration, and the [Locadex](/docs/platform/locadex/quickstart) AI agent. - **Enterprise — custom.** For larger teams with complex localization needs. Everything in Starter, plus forward-deployed localization engineers, custom workflows for any file format or framework, shared context across every Project, and enterprise-grade security, SLAs, and support. -Each free Organization gets 5M free platform credits to start. You will be rate-limited until you add a payment method. +Each free Organization gets 5M platform credits over a rolling 30-day window. You will be rate-limited until you add a payment method. ## Usage-based billing [#usage] @@ -33,7 +33,7 @@ Review consumption under **Organization > Usage > Translations**. Filter by Proj ### How usage is metered [#usage-metering] - **Translation workflows** are metered by input tokens, workflow type, and file format. -- **Ask AI** is charged in **Locadex Compute Units (LCUs)**. +- **Ask AI** is measured at the model provider's list-price token cost and converted to **Locadex Compute Units (LCUs)** when an Organization has a billing account. A free Organization without a billing account draws from the same rolling allowance as free translations. - **Google Slides** adds a per-slide **Layout Processing** charge to its translation workflow. This charge has no context surcharge. - **Context** adds a surcharge based on the input tokens and the amount of Project context provided. - **Locadex** agent runs are metered in **Locadex Compute Units (LCUs)**. An LCU measures the resources an agent uses to run end to end. @@ -48,7 +48,7 @@ Your **credit balance** is a prepaid wallet for platform usage, shown on the **B - **Granted** — any one-time signup credit. - **Included** — any credits included with your plan. -Every billable workflow, including translations and Ask AI responses, deducts its estimated cost from your balance. Purchased credits are non-refundable and expire one year from the purchase date. +Before a billable workflow starts, the platform checks that enough credits are available. It then charges the metered usage; some workflows reserve an estimate and reconcile it after completion. Purchased credits are non-refundable and expire one year from the purchase date. ### Buying credits [#buying-credits] diff --git a/docs/en-US/platform/dashboard/guides/using-ask-ai.mdx b/docs/en-US/platform/dashboard/guides/using-ask-ai.mdx index eb17b7048..e8e23926c 100644 --- a/docs/en-US/platform/dashboard/guides/using-ask-ai.mdx +++ b/docs/en-US/platform/dashboard/guides/using-ask-ai.mdx @@ -35,8 +35,8 @@ Chats are scoped to your user and current workspace. Switching Organizations sta ## Usage and billing [#usage-billing] -Ask AI is available on every plan and is charged in Locadex Compute Units (LCUs). +Ask AI is available on every plan. When an Organization has a billing account, usage is measured at the model provider's list-price token cost and converted to [Locadex Compute Units (LCUs)](/docs/platform/dashboard/guides/managing-billing#usage-metering). A free Organization without a billing account draws from the same rolling allowance as free translations. Enterprise workspaces require an active billing account. -Your workspace credit balance is the usage ceiling; Ask AI has no separate daily message or spending limit. Short per-minute limits prevent bursts. If a request is blocked, the panel explains whether to wait briefly, add credits, or review billing. +Your available credit balance or free allowance is the usage ceiling. Ask AI has no separate daily message or spending limit. Short per-minute limits prevent bursts. If a request is blocked, the panel explains whether to wait briefly, add credits, or review billing. AI responses may be inaccurate. Confirm important instructions against the cited documentation before making changes.