# gt: General Translation CLI tool: Скачать
URL: https://generaltranslation.com/ru/docs/cli/download.mdx
---
title: Скачать
description: Как скачать переводы, которые ранее были поставлены в очередь или подготовлены
---

## Использование

```bash
npx gt download
```

<Callout type="info">
  **Примечание:** Для этой команды требуется production API-ключ! Получите его на
  [платформе](https://generaltranslation.com/dashboard).
</Callout>


## Обзор

Команда `gt download` скачивает готовые переводы, которые ранее были отправлены на перевод с помощью [`gt enqueue`](/docs/cli/enqueue) или [`gt stage`](/docs/cli/stage).

Обычно процесс выглядит так:

1. [`gt upload`](/docs/cli/upload) — загрузить исходные файлы на платформу General Translation
2. [`gt enqueue`](/docs/cli/enqueue) — поставить загруженные файлы в очередь на перевод
3. **`gt download`** — скачать готовые переводы

Такое разделение удобно в CI/CD-конвейерах, где каждый шаг выполняется на отдельном этапе или в отдельной задаче.

<Callout type="warn">
  **Только для использования в production!**

  Эта команда предназначена для продакшен-сборок и **не должна использоваться в процессе разработки**.
  Не забудьте указать production API-ключ (`GT_API_KEY`) и ID проекта (`GT_PROJECT_ID`) в переменных окружения.
</Callout>

## Как это работает

1. Читает ваш `gt.config.json`, чтобы определить конфигурацию файлов
2. Если включён `stageTranslations`, считывает данные подготовленной версии; в противном случае собирает файлы и вычисляет их хеши, чтобы определить, что нужно скачать
3. Опрашивает API General Translation, чтобы узнать, какие переводы уже готовы
4. Скачивает и сохраняет файлы переводов по путям вывода, указанным в конфигурации

## Флаги

Команда `download` принимает те же флаги, что и [`translate`](/docs/cli/translate#flags).

| Параметр          | Описание                                           | Тип      | Необязательный | По умолчанию       |
| ----------------- | -------------------------------------------------- | -------- | -------------- | ------------------ |
| `--api-key`       | Указать production API-ключ                        | `string` | `true`         |                    |
| `--project-id`    | Указать ID проекта                                 | `string` | `true`         |                    |
| `--version-id`    | Указать ID версии (по умолчанию — хеш содержимого) | `string` | `true`         |                    |
| `--config <path>` | Указать путь к файлу конфигурации GT               | `string` | `true`         | `"gt.config.json"` |

| `--timeout`                     | Указать тайм-аут запроса в секундах                                               | `number`   | `true`         | `900`              |
| `--new, --locales <locales>`    | Указать локали, на которые нужно перевести проект                                 | `[string]` | `true`         |                    |
| `--default-locale <locale>`     | Указать исходную локаль проекта                                                   | `string`   | `true`         | `en`               |
| `--dry-run`                     | Выполнить команду в режиме пробного запуска                                       | `flag`     | `true`         | `false`            |
| `--force`                       | Принудительно скачать все переводы, перезаписав локальные изменения               | `flag`     | `true`         | `false`            |
| `--force-download`              | Принудительно скачать все переводы, перезаписав локальные изменения               | `flag`     | `true`         | `false`            |

## Пример: раздельный CI-конвейер

```bash
# Этап 1: Загрузка исходных файлов
npx gt upload

# Этап 2: Постановка переводов в очередь
npx gt enqueue

# Этап 3: Скачивание по готовности
npx gt download
```