Tripo: 3D Generation

Tripo создаёт файл 3D-модели по письменному описанию объекта. Более широкие процессы производителя разделяют геометрию, текстурирование и последующую обработку модели; проверяйте готовую сетку с нескольких ракурсов и сохраняйте реальные файлы для нужной сцены или редактора.

Ailoot Ultra · 3D POST /v1/3d/generations tripo3d

О модели

Описание раскрывает возможности модели. Доступные в Ailoot входные данные, результаты и параметры выбранного метода перечислены ниже.

Tripo создаёт 3D-модели по описанию или визуальному референсу. Его процессы отделяют генерацию объекта от последующих шагов: текстурирования, создания скелета и преобразования. Начните с определения нужного материала и операции его создания: статическая сетка для сцены, текстурированный объект для рендеринга или модель для дальнейшей подготовки в 3D-редакторе.

В задании на создание модели по тексту опишите форму объекта и его важные части. Небольшой фонарь можно задать через корпус, ручку, отверстия и пропорции; существо — через силуэт, конечности и позу. Укажите материал или визуальный стиль, если они важны для результата. Сосредоточьте описание на самом объекте, чтобы сгенерированную геометрию можно было оценить по ясному проекту.

Для процесса производителя с референсами подготовьте изображения, показывающие контур и отличительные признаки объекта. Несколько видов должны описывать один объект с согласованными пропорциями и аксессуарами. Проверяйте скрытые на референсе части после генерации: убедительный вид спереди не устанавливает соответствие задней стороны, нижней части или соединений компонентов предполагаемому проекту.

Сохраняйте выбранную версию модели вместе с запросом. Интерфейс генерации Tripo определяет операцию отдельно от настройки версии модели, а документированный пример создания модели по тексту выбирает явную версию. При сравнении материалов сохраняйте точную версию и параметры, чтобы не спутать изменение описания объекта с изменением настроек генерации.

Геометрия и внешний вид поверхности — отдельные производственные решения. Базовый процесс производителя различает модель без текстур и вывод с текстурами и материалами для физически корректного рендеринга. Выберите вид материала, нужный для следующего шага, затем проверьте и сетку, и сопутствующие файлы материалов. Изображение предпросмотра помогает сориентироваться, а сама модель нужна для сборки сцены и дальнейшего редактирования.

Осмотрите готовый объект с нескольких сторон. Проверьте силуэт, разделение частей, тонкие элементы, отверстия и поверхности стыков компонентов. Для стилизованного реквизита сравните пропорции с заданием. Для объекта, похожего на товар, проверьте, какие детали представлены геометрией, а какие — только оформлением поверхности. Определите признак, требующий правки, до изменения инструкции или референса.

Генерация выполняется асинхронной задачей. Сохраняйте исходный идентификатор задачи при проверке статуса и держите готовую модель, предпросмотр и прочие возвращённые файлы вместе. Документированный результат включает поля вывода, относящиеся к модели, и отрендеренные изображения. Сохраняйте сами файлы для следующего производственного шага, не полагаясь на временную ссылку и не считая предпросмотр полным результатом в формате 3D.

Импортируйте модель в нужный редактор или среду просмотра и проверьте там ориентацию, масштаб, материалы и геометрию. Реквизит для сцены, крупный план рендера и персонаж, подготовленный к анимации, требуют разной финальной обработки. Сохраняйте рабочую копию для правок и сгенерированный исходный материал вместе с заданием и референсами. Если нужна другая операция, например работа с текстурами или создание скелета, осознанно выбирайте её и проверяйте полученный материал как отдельный этап.

Ailoot Ultra · 3D POST /v1/3d/generations tripo3d

tripo3d

Tripo /tripo3d

Начало

Допустимые входные данные: Текст
Результаты: model_3d · Картинки

Доступно в Ailoot · входные данные и методы

Ailoot Ultra · 3D POST /v1/3d/generations

Входные данные: text
Результат: model_3d, image

Поле	Тип	Требование	Значения и ограничения	По умолчанию
Поле`model`	Тип`string`	ТребованиеОбязательно	Значения и ограничения tripo3d Условия: Используйте идентификатор модели Ailoot.	По умолчанию—
Поле`type`	Тип`string`	ТребованиеОбязательно	Значения и ограничения text_to_model, image_to_model, multiview_to_model, texture_model, animate_prerigcheck, animate_rig, animate_retarget, stylize_model, convert_model Условия: Полный пример использует text_to_model; другие типы задач требуют документированных для них входных данных.	По умолчанию—
Поле`model_version`	Тип`string`	ТребованиеОбязательно	Значения и ограничения v2.0-20240919, v1.4-20240625, v2.5-20250123, v3.0-20250812, Turbo-v1.0-20250506 Условия: Выберите явно документированную версию; в этом примере используется v3.0-20250812.	По умолчанию—
Поле`prompt`	Тип`string`	ТребованиеОбязательно	Значения и ограничения Условия: Опишите объект, который нужно создать.	По умолчанию—

Параметры и жизненный цикл метода

Параметр	Контракт
Параметр`content_type`	Контрактapplication/json
Параметр`required`	Контрактmodel, type, model_version, prompt
Параметр`optional`	Контракт
Параметр`material_types`	Контрактtext
Параметр`conditions`	КонтрактИспользуйте идентификатор модели Ailoot., Полный пример использует text_to_model; другие типы задач требуют документированных для них входных данных., Выберите явно документированную версию; в этом примере используется v3.0-20250812., Опишите объект, который нужно создать.

Жизненный цикл: submit_once_poll_original

GET /v1/3d/generations/{request_id}

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Тарифы

Как рассчитывается итоговая плата

Отображаемые тарифы позволяют оценить стоимость до генерации. Итоговое списание рассчитывается по стоимости, записанной для исходной генерации. Измеренная длительность результата и прогнозные объёмы не являются итоговым оплачиваемым объёмом.

Тарифная справка не добавляет режимы запроса. Поддерживаемые параметры указаны для выбранного метода.

Быстрый режим: Не указано При выборе быстрого режима
Режим flex: Не указано При выборе режима flex
Максимальная интенсивность рассуждений: Не указано При максимальной интенсивности рассуждений с корректировкой по умолчанию (default)

Оценочные ставки для сравнения

Цены по конфигурациям

Сопоставьте каждую плату с указанными условиями. Для каждого набора альтернативных конфигураций используйте одну ставку.

Конфигурация	Шкала ставок	Прогноз количества	Плата
КонфигурацияБазовые тарифы на токены	Шкала ставокБазовая ставка	Прогноз количества—	Плата Вход · Входные токены · Оценка только для сравнения — / 1K токенов Выход · Выходные токены · Оценка только для сравнения — / 1K токенов Вход · Чтение кэша · Оценка только для сравнения — / 1K токенов Вход · Запись в кэш · Оценка только для сравнения — / 1K токенов Вход · Запись в кэш, 1 час · Оценка только для сравнения — / 1K токенов
КонфигурацияОриентировочная стоимость генерации	Шкала ставок—	Прогноз количестваОценка для одной генерации	Плата Выход · Оценочная стоимость генерации · Оценка только для сравнения $1.35 оценка до генерации Эта оценка не является дополнительным списанием или фиксированным тарифом для завершённой генерации.

Ailoot резервирует расчётную сумму перед запросом. После получения результата списывает итоговую плату по измеренному расходу. Для окончательного списания за потоковый ответ используется итоговая запись расхода. Как работают резервирование и расчёт →

Примеры запросов

Ailoot Ultra · 3D

curl · создать один раз и сохранить подтверждениеПрочитать исходную задачуСохранить каждый готовый материал, принадлежащий вам

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
cat > request.json <<'JSON'
{
  "model": "tripo3d",
  "type": "text_to_model",
  "prompt": "a cute pig",
  "model_version": "v3.0-20250812"
}
JSON
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/3d/generations \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
# Create once; retain id, polling_url, original task identifiers and every header.

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_STATUS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path("result.json").read_text())
u=urljoin("https://api.ailoot.ai",r["polling_url"])
p=urlsplit(u)
if p.scheme!="https" or p.netloc!="api.ailoot.ai" or p.username or p.password:
    raise SystemExit("Unexpected returned polling URL; preserve the response")
subprocess.run(["curl","--fail-with-body","--silent","--show-error",u,"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-D","status-headers.txt","-o","status.json"],check=True)
# Read this same original polling_url again while pending.
# Preserve unknown/result_pending_check; do not repeat creation.
PY_STATUS

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_ASSETS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path("status.json").read_text())
roles={}
def visit(v,path=""):
    if isinstance(v,dict):
        for k,x in v.items(): visit(x,path+"/"+k)
    elif isinstance(v,list):
        for i,x in enumerate(v): visit(x,path+"/"+str(i))
    elif isinstance(v,str):
        u=urljoin("https://api.ailoot.ai",v); p=urlsplit(u)
        if p.scheme=="https" and p.netloc=="api.ailoot.ai" and not p.username and not p.password and p.path.startswith("/v1/media/assets/") and p.path.endswith("/content"):
            roles.setdefault(u,[]).append(path)
visit(r)
if not roles: raise SystemExit("No completed owned assets; retain the original status")
manifest=[]
for i,(u,paths) in enumerate(roles.items()):
    target=Path(f"asset-{i}.bin")
    subprocess.run(["curl","--fail-with-body","--silent","--show-error",u,"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-o",str(target)],check=True)
    raw=target.read_bytes()
    if not raw: raise SystemExit("Empty asset; retain original status and metadata")
    ext="glb" if raw[:4]==b"glTF" else "png" if raw[:8]==b"\x89PNG\r\n\x1a\n" else "jpg" if raw[:3]==b"\xff\xd8\xff" else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "mp4" if raw[4:8]==b"ftyp" else "bin"
    name=f"asset-{i}.{ext}"
    if target.name!=name: target.rename(name)
    manifest.append({"file":name,"response_paths":paths,"bytes":len(raw)})
Path("asset-manifest.json").write_text(json.dumps(manifest,indent=2))
print("Saved",len(manifest),"unique owned assets; every response role retained")
PY_ASSETS

Получить и сохранить результаты

Ailoot Ultra · 3D

Загрузите каждое полученное изображение или сохраните его содержимое Base64

GET /v1/3d/generations/{request_id}
GET /v1/media/assets
GET /v1/media/assets/{asset_id}

Сохраняйте все готовые результаты

Сохраняйте каждый полностью полученный ответ, файл и элемент содержимого.

Сохраните полный ответ и заголовки, исходные идентификаторы, каждый фактический результат и все поля использования и учёта. Сохраните каждый уникальный ресурс, принадлежащий Ailoot, и каждую роль, которая на него ссылается.

Если нужно проверить исходный ответ

Сохраните возвращённый публичный id задачи или операции и все заголовки. Проверяйте только исходную задачу; unknown или result_pending_check не разрешают создавать новую.

Поля ответа

Поле	Тип
Поле`id`	Типstring
Поле`polling_url`	Типstring
Поле`provider_task_id`	Типstring
Поле`code`	Типinteger
Поле`data.task_id`	Типstring
Поле`data.status`	Типstring
Поле`data.progress`	Типinteger
Поле`data.output.*`	Типstring
Поле`data.result.*.url`	Типstring
Поле`data.result.*.type`	Типstring
Поле`data.thumbnail`	Типstring

Псевдонимы

Псевдонимы моделей

Ailoot Ultra tripo3d

Псевдонимы путей метода

Используйте пути методов, указанные выше.

Связанные ID для вызова

tripo3d

FAQ · Tripo: 3D Generation

Какие входные данные и результаты доступны?: POST /v1/3d/generations · tripo3d: text → model_3d, image
Какие поля использует запрос?: POST /v1/3d/generations · tripo3d: model, type, model_version, prompt

Tripo: 3D Generation