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

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

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

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

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

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

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

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

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

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

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

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

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

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

Проблемы? ИИ застрял или столкнулся с ошибкой

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

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

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

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

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

Bash

npm install -g tripo-cli

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

Проблемы? npm не найден или возникла ошибка прав доступа

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

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

Bash

tripo login

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

Страница авторизации устройства Tripo CLI в браузере с кодом подтверждения

Проблемы? Браузер не открылся или вход не завершился

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

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

Bash

tripo doctor

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

Проблемы? Одна из проверок не прошла

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

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

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

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

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

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

Bash

tripo make "a cute low poly fox"

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

Проблемы? Генерация не началась или прервалась на середине

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

Шаг 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

Файлы, входящие в Skill

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

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

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

Показать полную таблицу команд и общие флаги

Команда	Назначение
`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.

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

Это продвинутый раздел; для первой генерации он не нужен. Семь встроенных предустановок применяют полезные параметры и этапы обработки за один раз через --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.

Показать таблицу кодов выхода

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

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

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

Показать таблицу переменных среды

Переменная	Назначение
`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`