Введение
Tripo H3.1 Text to 3D превращает описание предмета в 3D-объект, обычно GLB с текстурами. Сначала создаётся опорное изображение, затем сетка. image_seed относится к первому этапу; для геометрии и текстур предусмотрены отдельные значения seed.
Ключевые возможности и особенности
Металл по словесному описанию
Состаренный водолазный шлем занял 141 секунду с настройками по умолчанию: 46,9 МБ, около 1,49 млн треугольников и три карты по 2048 пикселей. Видны заклёпки, зелёная патина и круглый иллюминатор.
Части для дальнейшей работы
Робот был готов за 118 секунд: GLB 1,48 МБ с 17 узлами без текстур и 48 411 треугольниками. generate_parts отменяет текстуры и четырёхугольники; вне этого режима quad_mesh даёт FBX.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
prompt | Да | Для объекта по тексту: Обязательное описание до 1024 символов: целый предмет, форма, материал, цвет, стиль и размер. Не менее 1 символов · Не более 1024 символов |
negative_prompt | Нет | Для объекта по тексту: Короткие исключения до 255 символов, например основание или постамент. Не более 255 символов |
generate_texture | Нет | Для объекта по тексту: Включено по умолчанию; для удаления цветовой текстуры отключите также |
generate_pbr | Нет | Для объекта по тексту: Включено по умолчанию; материалы PBR активируют текстуры даже при выключенном |
texture_quality | Нет | Для объекта по тексту: standard по умолчанию; detailed и extreme (8K) имеют отдельные доплаты; fast использует v3.5 по цене standard; без текстур доплаты за качество нет. |
texture_version | Нет | Для объекта по тексту: Выберите стандартную v3.0-20250812 или v3.5-20260815; fast и удаление освещения используют v3.5. |
remove_lighting | Нет | Для объекта по тексту: Включено по умолчанию, действует только с v3.5; удаляет освещение, запечённое в изображении. По умолчанию: |
geometry_quality | Нет | Для объекта по тексту: standard либо detailed; detailed добавляет детализацию геометрии и отдельную доплату. |
quad_mesh | Нет | Для объекта по тексту: Создаёт четырёхугольную сетку FBX вместо GLB; при |
low_poly | Нет | Для объекта по тексту: Низкополигональная обработка с видом ручного моделирования и своей доплатой; рекомендуется |
generate_parts | Нет | Для объекта по тексту: Разделяет на треугольные части без текстур; параметры и доплаты текстур и четырёхугольников заменяются доплатой за части. По умолчанию: |
face_limit | Нет | Для объекта по тексту: Цель 1000–2 000 000 граней для описанного предмета; с |
auto_size | Нет | Для объекта по тексту: Выключено по умолчанию; оценивает реальные размеры и требует текстурированного результата. По умолчанию: |
uv_unwrap | Нет | Для объекта по тексту: Включено по умолчанию; отключение экспорта UV сокращает обработку и размер, но убирает координаты для последующих текстур. По умолчанию: |
seed | Нет | Для объекта по тексту: Значение seed геометрии для сравнения одного изменения за раз, без гарантии точного повтора. |
image_seed | Нет | Для объекта по тексту: Значение seed опорного изображения до построения 3D для сравнений без гарантии точного повторения. |
texture_seed | Нет | Для объекта по тексту: Значение seed текстур для сравнения поверхностей без гарантии одинаковой выдачи. |
Стоимость
$0.288 / модель
У текстового запроса ниже базовая плата за сетку, чем у изображения H3.1, при той же структуре доплат за текстуры, detailed или 8K, подробную геометрию, четырёхугольники и low-poly. generate_parts заменяет доплаты за текстуры и четырёхугольники своей доплатой за части. Неудачные запросы не оплачиваются.
Сценарии использования
Разработайте вымышленный предмет
Опишите шлем, чайник или игрушку без фотографии. Сначала оцените пропорции, цвет и характер материала.
Подготовьте структуру для редактирования
Осмотрите отдельные части в редакторе и назначьте свои материалы. Для печати проверьте геометрию и размеры.
Руководство по промптам и практические советы
Начните с основной формы
Опишите один предмет целиком: форму, материал, цвет, стиль и размер. prompt допускает 1024 символа, а negative_prompt — 255 для короткого списка исключений.
Метафоры могут упрощаться
Элементы лисы получились лишь частично: у оранжевого глазурованного чайника на носике есть маленькая голова лисы с острыми ушами, носом и глазами, а сзади — оранжевые выступы, похожие на уши или хвосты. Тело свернувшейся спящей лисы и хвост в роли ручки не получились; ручка осталась обычной высокой дугой. Тест занял 91 секунду и дал 59 722 треугольника в файле размером 3,38 МБ.
Настройте выдачу
face_limit задаётся от 1000 до 2 000 000; для low_poly рекомендуется не больше 20 000. Сравнивайте по одному этапу с тремя значениями seed, без обещания точного повторения. Проверьте скрытые стороны и отверстия.
Быстрый старт 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/h3.1/text-to-3d",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"low_poly": false,
"quad_mesh": false,
"generate_pbr": true,
"generate_parts": false,
"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.










