Введение
Tripo P1, также известная как Smart Mesh P1.0, — модель Tripo AI для построения аккуратных низкополигональных сеток по изображениям. Целевой диапазон составляет 50–20 000 граней для игровых предметов, мобильных 3D-сцен и пользовательских миров. Текстуры можно включить в GLB.
Ключевые возможности и особенности
Узнаваемый силуэт при небольшой сетке
Оранжево-белый игрушечный космонавт сохранил забрало и рюкзак при 4970 треугольниках. Тест с настройками по умолчанию занял 82 секунды: GLB 2,67 МБ, UV и три карты по 2048 пикселей.
Ботинок для собственной отделки
При цели 3000 граней, без текстур и UV, ботинок получил 2804 треугольника за 19 секунд. В файле 0,07 МБ нет материалов, но видны шнурки, каблук и протектор.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
image_url | Да | Для модели P1: Изображение JPEG, PNG или WebP до 10 МБ; покажите один предмет целиком. Не менее 1 символов |
generate_texture | Нет | Для модели P1: Включено по умолчанию; для удаления цветовой текстуры отключите также |
generate_pbr | Нет | Для модели P1: Включено по умолчанию; материалы PBR активируют текстуры даже при выключенном |
texture_quality | Нет | Для модели P1: standard по умолчанию; detailed и extreme (8K) имеют отдельные доплаты; fast использует v3.5 по цене standard; без текстур доплаты за качество нет. |
texture_version | Нет | Для модели P1: Выберите стандартную v3.0-20250812 или v3.5-20260815; fast и удаление освещения используют v3.5. |
remove_lighting | Нет | Для модели P1: Включено по умолчанию, действует только с v3.5; удаляет освещение, запечённое в изображении. По умолчанию: |
face_limit | Нет | Для модели P1: Цель от 50 до 20 000 граней; без значения выбор остаётся за моделью. |
image_autofix | Нет | Для модели P1: Выключено по умолчанию; предварительно улучшает размытое изображение или низкое разрешение, увеличивая время. По умолчанию: |
model_orientation | Нет | Для модели P1: default сохраняет обычную ориентацию, |
texture_alignment | Нет | Для модели P1: |
auto_size | Нет | Для модели P1: Выключено по умолчанию; оценивает реальные размеры и требует текстурированного результата. По умолчанию: |
uv_unwrap | Нет | Для модели P1: Включено по умолчанию; отключение экспорта UV сокращает обработку и размер, но убирает координаты для последующих текстур. По умолчанию: |
seed | Нет | Для модели P1: Значение seed геометрии для сравнения одного изменения за раз, без гарантии точного повтора. |
texture_seed | Нет | Для модели P1: Значение seed текстур для сравнения поверхностей без гарантии одинаковой выдачи. |
Стоимость
$0.72 / модель
P1 оплачивается один раз за доставленную модель: основа за сетку и доплата за текстуры, если включён generate_texture или generate_pbr. У detailed и extreme (8K) свои уровни доплат; fast стоит как standard. Без текстур доплаты за их качество нет. Другие настройки P1 не меняют стоимость, неудачные запросы не оплачиваются.
Сценарии использования
Предметы для небольшого экрана
Подберите число граней для мобильной игры или AR-сцены и оцените силуэт с рабочей дистанции просмотра.
Заготовка для печати
Запросите сетку без материалов для подготовки к 3D-печати или собственному текстурированию. Проверьте стенки, отверстия и размеры перед изготовлением.
Руководство по промптам и практические советы
Покажите предмет целиком
Оставьте один объект и свободное место по краям. Ракурс в три четверти помогает передать глубину. image_url принимает JPEG, PNG или WebP до 10 МБ; текстовый промпт здесь не используется.
Выберите форму и отделку
Задайте face_limit от 50 до 20 000 или оставьте выбор P1. Для сетки без текстур отключите вместе generate_texture и generate_pbr. Сохраните uv_unwrap, если будете добавлять текстуры позже.
Сравнивайте по одному изменению
Используйте seed и texture_seed для организации сравнений, без гарантии одинакового результата. remove_lighting работает только с v3.5-20260815, а auto_size требует текстур. Осмотрите также заднюю и нижнюю стороны.
Быстрый старт API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "tripo/p1/image-to-3d",
"input": {
"generate_pbr": true,
"generate_texture": true,
"image_url": "https://example.com/reference.png",
"model_orientation": "default",
"texture_alignment": "original_image",
"texture_quality": "standard"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Аутентификация, полная схема, опрос статуса и обработка ошибок описаны в справочнике API.







