Tripo3D

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

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. Если это Windows PowerShell и выполнение сценариев отключено, выполни Set-ExecutionPolicy -Scope CurrentUser RemoteSigned (не от имени администратора) и повтори попытку. Перед входом спроси, на каком сайте мой аккаунт: международном developers.tripo3d.ai (ov) или для материкового Китая developers.tripo3d.com (cn). Не делай вывод по языку или способу входа. В зависимости от моего ответа выполни tripo login --region ov или tripo login --region cn. Передай мне URL авторизации и одноразовый код и не завершай команду, пока я авторизуюсь в браузере; не проси меня вставлять API-ключ в чат. В конце выполни tripo doctor и сообщи, прошли ли проверки аутентификации, сети и баланса.

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

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

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

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

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

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

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

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

Bash
npm install -g tripo-cli

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

Уже установлено? Выполните tripo update --check, чтобы проверить наличие новой версии, затем tripo update, чтобы её установить.

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

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

Для международного аккаунта на developers.tripo3d.ai (оплата через Stripe) выполните:

Bash
tripo login --region ov

Для аккаунта материкового Китая на developers.tripo3d.com (Alipay) используйте вместо этого tripo login --region cn. В интерактивном терминале tripo login без региона сначала попросит выбрать сайт для аккаунта.

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

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

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

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

Bash
tripo doctor

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

Проблемы? Одна из проверок не прошла
  • Не прошла аутентификация: вход не был завершён — выполните tripo login и войдите ещё раз;
  • Не прошла проверка сети: убедитесь, что компьютер открывает веб-страницы; в корпоративных и университетских сетях может понадобиться прокси;
  • Не прошла проверка баланса: кредитов недостаточно; генерация ещё не начиналась, и ничего не списано. Выполните tripo topup, чтобы открыть страницу оплаты.
Резервный вход и регионы (только если вход через браузер недоступен)
  • Если у вас уже есть API-ключ, выполните tripo login --key tsk_... либо задайте TRIPO_API_KEY вместе с TRIPO_REGION (ov или cn) для этого аккаунта;
  • API-ключ — это учётные данные аккаунта: никогда не вставляйте его в чат, исходный код, снимки экрана или логи;
  • tripo login --key tsk_... проверяет ключ в обоих регионах и автоматически сохраняет принявший его регион. Прямая установка TRIPO_API_KEY не выполняет это определение. Перед авторизацией в браузере явно выберите сайт: ov для международного, cn для материкового Китая;
  • В ИИ-агенте или другом неинтерактивном сеансе без ключа требуется --region. CLI выведет URL авторизации и одноразовый код, а затем будет ждать, пока человек авторизуется. До запуска спросите, какой сайт использует аккаунт; не определяйте его по языку или способу входа.

Windows / PowerShell

Команды на этой странице приведены для Bash. Они также работают в Windows; PowerShell лишь иначе разбирает некоторые токены, чем Bash или cURL. В PowerShell копируйте примеры ниже, а не блоки Bash как есть.

Разрешить запуск tripo

npm устанавливает shim tripo.ps1, который PowerShell по умолчанию блокирует:

PowerShell
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned

Заново откройте терминал и выполните tripo doctor. Права администратора не нужны. Если политику менять не хотите, используйте командную строку (cmd.exe).

Заключайте @last и флаги через запятую в кавычки

PowerShell воспринимает @name как особый синтаксис, а , — как разделитель списка:

PowerShell
tripo make "a cute low poly fox"
tripo view '@last'
tripo make hero.glb --then 'texture,rig'
tripo make '@last' --then 'convert:fbx'

В командной строке эти дополнительные кавычки не нужны.

Переменные среды

PowerShell
# Только текущее окно
$env:TRIPO_API_KEY = "tsk_..."
$env:TRIPO_REGION = "ov"
$env:TRIPO_PROFILE = "work-ov"

# Сохранить для пользователя Windows
[System.Environment]::SetEnvironmentVariable("TRIPO_API_KEY", "tsk_...", "User")
[System.Environment]::SetEnvironmentVariable("TRIPO_REGION", "ov", "User")

Конфигурация и история хранятся в %USERPROFILE%\.tripo (это аналог ~/.tripo в Windows).

JSON-конвейеры

PowerShell
# PowerShell 7+ (рекомендуется)
tripo make cat.png --json | tripo model texture --json | tripo anim rig --json

# Windows PowerShell 5.1
$json = tripo make cat.png --json --no-open
$json | tripo model texture --json

Если неанглийский промпт отображается искажённо, используйте Windows Terminal или сначала выполните chcp 65001.

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

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

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

Bash
tripo make "a cute low poly fox"

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

Проблемы? Генерация не началась или прервалась на середине
  • Недостаточно кредитов: генерация модели не началась, и ничего не списано. Выполните tripo topup, чтобы пополнить кредиты, затем повторите попытку;
  • Ошибка сети или HTTP 5xx при отправке: задача уже может существовать на сервере. Перед повторной отправкой проверьте замороженные кредиты через tripo balance и посмотрите в консоли. Если у вас есть ID задачи, продолжите с tripo task watch <task-id> --download;
  • Ожидание превысило лимит времени: задача всё ещё может выполняться, и при успехе будет списана плата. Продолжите с tripo task watch <task-id> --download; не повторяйте make и не используйте redo для восстановления после тайм-аута;
  • Задача завершилась с ошибкой: списанные кредиты возвращаются автоматически — попробуйте другое описание.

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

Bash
tripo view @last

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

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

  • Где лежат файлы: в новой папке внутри 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 mesh decimate [input] Уменьшение числа полигонов; v3.0 может развернуть UV в той же задаче
tripo mesh uv [input] Развёртка UV и перенос существующих текстур, рига и анимации
tripo task get/list/watch Запрос, вывод списка или ожидание задач
tripo history [--limit <n>] Показать локальную историю последних задач
tripo files upload <path> Загрузка файла и возврат его file_token
tripo batch run <manifest.yaml> Запуск возобновляемых массовых конвейеров с параллельностью и повторными попытками
tripo config / doctor Управление настройками и диагностика локальной среды
tripo update [--check] Установка последней версии CLI или только проверка обновления
tripo docs [--topic <topic>] Вывод встроенной документации для Agent и команд
tripo mcp Запуск CLI в качестве MCP-сервера
tripo completion <shell> Создание автодополнения для Bash, Zsh или Fish (не для PowerShell)

Команды 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

Ретопология и UV-развёртка

decimate по-прежнему по умолчанию использует v2.0. Для новой модели ретопологии выберите v3.0; --smart-uv разворачивает UV в той же задаче и поддерживается только в v3.0 (если с этим флагом не указать --model, будет выбран v3.0).

Bash
tripo mesh decimate hero.glb --model v3.0 --face-limit 5000 --smart-uv
tripo mesh uv hero.glb

Отдельный шаг uv переносит существующие текстуры, риг и анимацию на новую UV-развёртку, а также возвращает UV-атлас. Его входные данные не должны превышать 80 000 эквивалентных треугольников (один quad считается за два треугольника). Для больших моделей сначала выполните decimate, например tripo make hero.glb --then decimate:20000,uv. В PowerShell заключите цепочку в кавычки: 'decimate:20000,uv'.

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

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

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

Bash
tripo login --region ov --profile personal-ov
tripo login --region cn --profile work-cn
tripo use personal-ov
tripo whoami
tripo make "a fox" --profile personal-ov
tripo logout

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

Используйте регион, соответствующий каждому аккаунту. tripo topup открывает региональную страницу оплаты активного профиля: /billing на международном сайте или /billing/recharge на сайте материкового Китая.

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

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

  • 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.
  • tripo-p2 — модель Preview, её нужно явно выбрать через --model tripo-p2. Для низкополигонального вывода с quad добавьте -p quad=true; вывод с quad использует FBX, а P1 не поддерживает quad. Используйте псевдонимы моделей CLI: CLI преобразует их в датированные значения моделей, которые ожидает API.
  • Просмотрите план без загрузки, создания задач и расхода кредитов с помощью tripo make "a low-poly robot" --model tripo-p2 --dry-run.
  • Создание задач автоматически повторяется только при HTTP 429. Ошибка сети, тайм-аут или HTTP 5xx могут оставить результат отправки неопределённым; проверьте аккаунт перед повторной отправкой.
Показать таблицу кодов выхода
Код выхода Значение
0 Успешно
1 Непредвиденная или внутренняя ошибка
2 Неверное использование или параметры
3 Ошибка аутентификации
4 Недостаточно кредитов
5 Отклонено политикой в отношении содержимого
6 Задача завершилась с ошибкой (кредиты возвращены) или истекло время ожидания (задача может продолжаться; возобновите наблюдение)
7 Ошибка сети
8 Ресурс не найден
9 Ограничение частоты запросов; повторите попытку с задержкой

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

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

По умолчанию для официального международного API включена анонимная аналитика использования со случайным идентификатором установки. Она записывает результаты команд и метаданные задач, включая модель/тип, кредиты/длительность, категорию ошибки, формат вывода/число файлов и атрибуцию агента; промпты, пути к файлам, входные ресурсы, API-ключи и URL для скачивания исключены. API материкового Китая и пользовательские конечные точки API не отправляют эти события. Чтобы отказаться, задайте TRIPO_ANALYTICS_ENABLED=0.

Показать таблицу переменных среды
Переменная Назначение
TRIPO_API_KEY Переопределяет сохранённый ключ, не определяя его регион; в скриптах указывайте правильный TRIPO_REGION
TRIPO_PROFILE Именованный профиль аккаунта, эквивалент --profile
TRIPO_REGION Переопределение ov или cn для API-запросов; не заменяет login --region при неинтерактивной авторизации в браузере
TRIPO_API_BASE_URL Переопределение конечной точки API
TRIPO_PLATFORM_BASE_URL Переопределение конечной точки платформы
TRIPO_HOME Каталог настроек и истории; по умолчанию ~/.tripo
TRIPO_NO_UPDATE_CHECK Любое непустое значение (например, 1) отключает автоматическую проверку версии при запуске
TRIPO_NPM_REGISTRY URL реестра для проверки версии CLI; по умолчанию https://registry.npmjs.org. Установка использует настройки реестра npm
HTTPS_PROXY / HTTP_PROXY / NO_PROXY URL прокси и список обхода прокси для сетевых запросов CLI; строчные имена также работают
TRIPO_ANALYTICS_ENABLED Установите ровно 0, чтобы отключить анонимную аналитику использования; API материкового Китая и пользовательские конечные точки ничего не отправляют
TRIPO_LLM_BASE_URL Необязательная OpenAI-совместимая конечная точка для tripo ai
TRIPO_LLM_API_KEY Необязательный ключ LLM для tripo ai
TRIPO_LLM_MODEL Необязательная модель LLM для tripo ai
ПредыдущийУзлы ComfyUIДалееПлагин Codex