# Tripo CLI: пусть ИИ превращает текст и изображения в 3D-модели

Tripo CLI создан для ИИ-агентов и делает создание 3D-контента таким же простым, как переписка в чате. Работаете ли вы в ИИ-инструменте для программирования, таком как Codex, Claude Code или Cursor, или используете CLI напрямую — достаточно одного описания на естественном языке, изображения или готовой модели, чтобы сгенерировать или преобразовать 3D-модели, анимации и другие ассеты. CLI автоматически выполняет весь процесс: не нужно разбираться в API, версиях моделей или сложных параметрах.

## Что выбрать: CLI или API?

Tripo доступен в двух вариантах — потратьте десять секунд, чтобы выбрать подходящий:

| Продукт | Для каких задач | Куда перейти |
| --- | --- | --- |
| **Tripo CLI (эта страница)** | Новичкам: быстро задействовать возможности ИИ-3D через популярные инструменты вайб-кодинга | Читайте дальше |
| **Tripo API** | Профессиональным разработчикам: интегрировать возможности ИИ-3D в сайты, приложения или собственные бизнес-системы | [Быстрый старт](/ru/docs/quick-start) |

Не уверены? Просто начните с этой страницы: установка бесплатна, а кредиты списываются только тогда, когда вы действительно генерируете модель.

## Установка и вход (выберите один из двух путей)

Выберите один из двух путей установки ниже.

### Путь первый: пусть ИИ установит всё за меня (рекомендуется)

Если вы уже пользуетесь Cursor, Claude Code, Codex или другим ИИ-ассистентом, который умеет выполнять команды в терминале, это самый простой путь. Скопируйте запрос ниже и целиком отправьте его ассистенту:

```text
Настрой для меня Tripo CLI и объясни каждый шаг. Проверь, что установлен Node.js 20 или новее, затем выполни npm install -g tripo-cli. После этого попроси меня завершить tripo login в браузере; не проси вставлять API-ключ в чат. В конце выполни tripo doctor и сообщи, прошли ли проверки аутентификации, сети и баланса.
```

Что произойдёт дальше:

1. ИИ проверит ваш компьютер и, если Node.js отсутствует, сначала поможет его установить;
2. ИИ выполнит команду установки;
3. Теперь ваша очередь: в браузере откроется страница входа Tripo — войдите и подтвердите код, показанный в вашем терминале (этот шаг должны выполнить именно вы; никогда не отправляйте ИИ никакие ключи);
4. ИИ выполнит `tripo doctor`; когда все проверки пройдут, настройка завершена.

После этого сразу переходите к следующему разделу — «Создайте первую 3D-модель».

<details>
<summary><strong>Проблемы?</strong> ИИ застрял или столкнулся с ошибкой</summary>

- Вставьте ошибку из терминала в чат с ИИ как есть и дайте ему продолжить; большинство проблем он способен решить сам;
- Вход не завершился: заново откройте страницу входа и перед подтверждением ещё раз сверьте код с тем, что показан в вашем терминале;
- Если ничего не помогает, перейдите к разделу «Путь второй: установка вручную» ниже — это всего три команды.

</details>

### Путь второй: установка вручную

Нет ИИ-ассистента? Ничего страшного — весь процесс состоит из трёх команд.

**Шаг 1: установите Tripo CLI**

Эта команда устанавливает команду `tripo` на ваш компьютер:

```bash
npm install -g tripo-cli
```

Обычно установка завершается без красного текста ошибок — это значит, что всё прошло успешно.

<details>
<summary><strong>Проблемы?</strong> npm не найден или возникла ошибка прав доступа</summary>

- `npm` не найден: Node.js ещё не установлен. Установите текущую LTS-версию (20 или новее) с [сайта Node.js](https://nodejs.org/), затем заново откройте терминал и попробуйте ещё раз;
- Ошибка прав доступа в macOS (EACCES): выполните вместо этого `sudo npm install -g tripo-cli` и введите пароль от компьютера, когда его попросят;
- Windows сообщает, что «выполнение сценариев отключено»: заново откройте PowerShell от имени администратора и попробуйте ещё раз.

</details>

**Шаг 2: войдите в аккаунт Tripo**

```bash
tripo login
```

Браузер автоматически откроет страницу авторизации (если аккаунта ещё нет, сначала зарегистрируйтесь там же). На странице появится код подтверждения — **подтверждайте его только после того, как убедитесь, что он совпадает с кодом в вашем терминале.** После входа терминал сообщит, что вы вошли.

![Страница авторизации устройства Tripo CLI в браузере с кодом подтверждения](/assets/images/docs/cli/device-authorization-en.webp)

<details>
<summary><strong>Проблемы?</strong> Браузер не открылся или вход не завершился</summary>

- Вход не завершился: выполните `tripo login` ещё раз и подтверждайте код только после сверки с терминалом;
- Браузер никак не реагирует: вручную скопируйте адрес, напечатанный в терминале, в браузер;
- Авторизация через браузер временно недоступна: CLI откроет вместо неё страницу API-ключа — см. «Резервный вход и регионы» в конце этого раздела.

</details>

**Шаг 3: проверьте, что всё готово**

```bash
tripo doctor
```

Команда по очереди проверяет статус входа, доступ к сети и баланс кредитов. Когда все три проверки пройдены, настройка завершена.

<details>
<summary><strong>Проблемы?</strong> Одна из проверок не прошла</summary>

- Не прошла аутентификация: вход не был завершён — выполните `tripo login` и войдите ещё раз;
- Не прошла проверка сети: убедитесь, что компьютер открывает веб-страницы; в корпоративных и университетских сетях может понадобиться прокси;
- Не прошла проверка баланса: кредитов недостаточно; генерация ещё не начиналась, и ничего не списано. Выполните `tripo topup`, чтобы открыть страницу оплаты.

</details>

<details>
<summary><strong>Резервный вход и регионы</strong> (только если вход через браузер недоступен)</summary>

- Если у вас уже есть API-ключ, выполните `tripo login --key tsk_...` или задайте переменную среды `TRIPO_API_KEY`;
- API-ключ — это учётные данные аккаунта: никогда не вставляйте его в чат, исходный код, снимки экрана или логи;
- Один и тот же вариант установки работает и с международными аккаунтами, и с аккаунтами материкового Китая: CLI проверяет ключ в обоих регионах и автоматически сохраняет тот регион, который его принял.

</details>

## Создайте первую 3D-модель

**Шаг 1: сгенерируйте модель из одного предложения**

Слова в кавычках — это ваш запрос; замените их описанием того, что хотите создать:

```bash
tripo make "a cute low poly fox"
```

Не закрывайте терминал, пока команда выполняется. Tripo CLI сам выберет подходящий процесс и модель, дождётся завершения задачи и скачает файлы в папку `tripo-out` в текущем каталоге. Обычно всё занимает несколько минут и стоит небольшое количество кредитов.

<details>
<summary><strong>Проблемы?</strong> Генерация не началась или прервалась на середине</summary>

- Недостаточно кредитов: генерация модели не началась, и ничего не списано. Выполните `tripo topup`, чтобы пополнить кредиты, затем повторите попытку;
- Ошибка сети: убедитесь, что компьютер подключён к интернету, и выполните ту же команду ещё раз;
- Задача завершилась с ошибкой: списанные кредиты возвращаются автоматически — попробуйте другое описание.

</details>

**Шаг 2: откройте предпросмотр**

```bash
tripo view @last
```

`@last` означает «последняя задача». В браузере откроется интерактивный 3D-предпросмотр, который можно вращать мышью, — если вы видите свою модель, у вас всё получилось!

**После первого успеха: что у вас теперь есть**

- **Где лежат файлы**: в новой папке внутри `tripo-out` находятся скачанная 3D-модель и `task.json` — запись о том, как была создана задача; если сервер предоставляет изображение предпросмотра, там же будет `preview.png`.
- **Открыть ещё раз**: в любой момент выполните `tripo view @last` или откройте любой файл модели командой `tripo view <file>`.
- **Сколько это стоило**: выполните `tripo balance`, чтобы проверить баланс кредитов.
- **Не хотите запоминать команды?** Просто выполните `tripo` — откроется интерактивное меню с подсказками: вход, генерация, предпросмотр и пополнение находятся там.
- **Что дальше**: генерируйте из изображений (следующий раздел), доверьте управление ИИ-ассистенту («Помогите ИИ-агенту программирования освоить CLI») или обрабатывайте модели массово («Готовые процессы и конвейеры»).

## Генерация из изображения или существующей модели

Когда текстовый пример сработал, вместо текста можно передавать локальные файлы. `concept.png`, `front.png` и `hero.glb` ниже — примеры имён; замените их путями к своим файлам:

```bash
tripo make concept.png --for print
tripo make front.png back.png
tripo make hero.glb --then texture,rig
tripo make @last --then convert:fbx
```

- Строка 1: превращает концепт-изображение в модель, готовую к печати;
- Строка 2: генерирует по изображениям спереди и сзади одновременно для более точной детализации;
- Строка 3: текстурирует существующую модель и создаёт для неё риг;
- Строка 4: преобразует последний результат в FBX.

## Помогите ИИ-агенту программирования освоить CLI

Если вы не используете ИИ-агента программирования, пропустите этот раздел. Пакет npm содержит Agent Skill — справочник команд, готовые сценарии и рекомендации по устранению ошибок, — чтобы агент мог правильно пользоваться CLI. Попросите агента выполнить эти команды, чтобы вывести в терминале полные инструкции или отдельную тему:

```bash
tripo docs --llm
tripo docs --topic commands/make
tripo docs --topic examples/game-asset
```

<details>
<summary><strong>Файлы, входящие в Skill</strong></summary>

```text
skill/
├── SKILL.md
├── common-errors.md
├── commands/
│   ├── account.md
│   ├── batch.md
│   ├── generate.md
│   ├── make.md
│   ├── process.md
│   ├── task.md
│   └── view.md
└── examples/
    ├── animation.md
    ├── ar-web.md
    ├── film.md
    ├── game-asset.md
    ├── pipes.md
    └── print.md
```

</details>

## Справочник команд

Эту таблицу не нужно запоминать: в повседневной работе новичкам достаточно `tripo` (интерактивное меню), `tripo make` (генерация), `tripo view` (предпросмотр) и `tripo doctor` (проверка состояния). Остальное раскрывайте только тогда, когда появится конкретная задача.

<details>
<summary><strong>Показать полную таблицу команд и общие флаги</strong></summary>

| Команда | Назначение |
| --- | --- |
| `tripo make <input...>` | Генерация, обработка и скачивание одной командой |
| `tripo ai [description]` | Планирование задания, подтверждение и выполнение |
| `tripo view [task\|file]` | Открытие интерактивного локального предпросмотра 3D |
| `tripo redo [task]` | Повтор запроса с новым случайным зерном |
| `tripo login / logout / whoami / use` | Авторизация и переключение именованных профилей аккаунта |
| `tripo topup / balance / usage` | Открытие региональной страницы оплаты и проверка кредитов |
| `tripo generate <endpoint>` | Явный доступ ко всем восьми конечным точкам генерации |
| `tripo model / anim / mesh <step>` | Запуск уточнения, текстурирования, риггинга, преобразования, сегментации и других этапов обработки |
| `tripo task get/list/watch` | Запрос, вывод списка или ожидание задач |
| `tripo history [--limit <n>]` | Показать локальную историю последних задач |
| `tripo files upload <path>` | Загрузка файла и возврат его `file_token` |
| `tripo batch run <manifest.yaml>` | Запуск возобновляемых массовых конвейеров с параллельностью и повторными попытками |
| `tripo config / doctor` | Управление настройками и диагностика локальной среды |
| `tripo docs [--topic <topic>]` | Вывод встроенной документации для Agent и команд |
| `tripo mcp` | Запуск CLI в качестве MCP-сервера |
| `tripo completion <shell>` | Создание автодополнения для Bash, Zsh или Fish |

Команды `make`, `ai` и `generate`, а также подкоманды обработки в `model`, `anim` и `mesh` поддерживают `-o/--out`, `--no-wait`, `--no-download`, `--name`, `--timeout`, `--notify` и повторяемый параметр `--param key=value`. Глобальные флаги автоматизации включают `--json`, `--yes`, `--quiet`, `--no-open` и `--profile`.

</details>

## Готовые процессы и конвейеры

Это продвинутый раздел; для первой генерации он не нужен. Семь встроенных предустановок применяют полезные параметры и этапы обработки за один раз через `--for <preset>`:

`game-mobile` · `game-pc` · `film` · `print` · `ar-web` · `anim` · `toy`

```bash
# Mobile game asset: low-poly generation, texture, then FBX
tripo make "sci-fi crate" --for game-mobile

# Print asset: watertight output, STL, and a flat bottom
tripo make "chess knight" --for print

# Explicit processing chain
tripo make cat.png --then texture,rig,convert:fbx

# The same chain as NDJSON pipes
tripo make cat.png --json | tripo model texture --json | tripo anim rig --json

# Resumable batch processing
tripo batch run assets.yaml --concurrency 2
```

Ссылки на задачи, такие как `@last`, `@2` и `@name`, работают везде, где принимается идентификатор задачи.

## Несколько аккаунтов и регионов

Если вы используете один аккаунт Tripo, пропустите этот раздел. Учётные данные хранятся в именованных профилях, поэтому вход во второй аккаунт не перезаписывает первый:

```bash
tripo login
tripo login --profile work-cn
tripo use
tripo whoami
tripo make "a fox" --profile work-cn
tripo logout
```

Каждый профиль хранит собственный ключ и регион. Переменная среды `TRIPO_PROFILE` выбирает профиль для текущей среды, а `TRIPO_API_KEY` обходит все профили и имеет наивысший приоритет.

## Примечания для ИИ-агентов программирования

Обычные пользователи могут пропустить этот раздел. Эти правила помогают ИИ-агентам программирования правильно ждать задачи и читать машиночитаемый вывод.

- `tripo make` и `tripo task watch` — блокирующие команды. Дождитесь завершения процесса вместо реализации дополнительного цикла опроса.
- С флагом `--json` большинство одноразовых команд выводят в stdout одну итоговую строку JSON. Команда `tripo task watch --json` вместо этого потоково выводит события прогресса NDJSON, а затем итоговый результат.
- Если `preview.png` существует, проверьте его, прежде чем решать, продолжать ли конвейер или запускать `tripo redo`.
- Не придумывайте параметры и не навязывайте устаревшие версии моделей. Используйте `tripo docs --topic ...`, чтобы узнать поддерживаемые флаги.
- Для запроса низкополигональной модели или ограничения в 20 000 граней и менее выбирается `tripo-p1`; для остальных задач по умолчанию используется `tripo-v3.1`.

<details>
<summary><strong>Показать таблицу кодов выхода</strong></summary>

| Код выхода | Значение |
| --- | --- |
| `0` | Успешно |
| `1` | Непредвиденная или внутренняя ошибка |
| `2` | Неверное использование или параметры |
| `3` | Ошибка аутентификации |
| `4` | Недостаточно кредитов |
| `5` | Отклонено политикой в отношении содержимого |
| `6` | Задача завершилась с ошибкой; кредиты возвращаются автоматически |
| `7` | Ошибка сети |
| `8` | Ресурс не найден |
| `9` | Ограничение частоты запросов; повторите попытку с задержкой |

</details>

## Переменные среды для автоматизации

Для обычной интерактивной работы переменные среды не нужны; они предназначены для CI, скриптов и продвинутых сценариев с агентами. Помните: никогда не фиксируйте API-ключ в репозитории, не вставляйте его в документацию и не включайте в снимки экрана или журналы.

<details>
<summary><strong>Показать таблицу переменных среды</strong></summary>

| Переменная | Назначение |
| --- | --- |
| `TRIPO_API_KEY` | API-ключ; имеет наивысший приоритет и подходит для CI или Agent |
| `TRIPO_PROFILE` | Именованный профиль аккаунта, эквивалент `--profile` |
| `TRIPO_REGION` | Необязательное переопределение `ov` или `cn`; обычно определяется автоматически |
| `TRIPO_API_BASE_URL` | Переопределение конечной точки API |
| `TRIPO_PLATFORM_BASE_URL` | Переопределение конечной точки платформы |
| `TRIPO_HOME` | Каталог настроек и истории; по умолчанию `~/.tripo` |
| `TRIPO_LLM_BASE_URL` | Необязательная OpenAI-совместимая конечная точка для `tripo ai` |
| `TRIPO_LLM_API_KEY` | Необязательный ключ LLM для `tripo ai` |
| `TRIPO_LLM_MODEL` | Необязательная модель LLM для `tripo ai` |

</details>