Мультивид в 3D-модель — серия P

POST /v3/generation/multiview-to-model

Создайте 3D-модель из многовидовых изображений с помощью моделей серии P. Оптимизирован для генерации низкополигональных изображений с чистой топологией.

Ключевые отличия от стандартного

Оптимизирован для low-poly вывода (P1-20260311: 50–20 000 граней; P2-20260801: до 50 000)
quad поддерживается только моделью P2-20260801; smart_low_poly, generate_parts и geometry_quality не поддерживаются.

Параметры запроса

Параметр	Тип	Требуется	По умолчанию	Описание
inputs	строка[]	Требуется	-	Список из 4 многоэкранных изображений [спереди, слева, сзади, справа]
original_task_id	строка	Необязательно	-	Задача ID из предыдущего поколения мультипредставлений. Взаимоисключающие входы
model	строка	Требуется	-	Версия модели серии P. Значения: `P1-20260311` (оптимизирована для low-poly), `P2-20260801` (новое поколение, поддерживает вывод quad; Preview)
texture_alignment	строка	Необязательно	original_image	`original_image` или `geometry`
orientation	строка	Необязательно	по умолчанию	`default` или `align_image`
model_seed	целое число	Необязательно	случайный	Случайное начальное значение для геометрии
face_limit	целое число	Необязательно	адаптивный	Максимальное количество полигонов. `P1-20260311`: 50–20 000; `P2-20260801` треугольники: 48–50 000, при `quad=true`: 48–25 000
texture	логическое значение	Необязательно	правда	Включить текстурные карты
pbr	логическое значение	Необязательно	правда	Включите PBR. Форсирует текстуру = true
texture_seed	целое число	Необязательно	случайный	Случайное начальное значение для текстуры
texture_quality	строка	Необязательно	стандартный	`standard`, `detailed` или `extreme`
auto_size	логическое значение	Необязательно	ложный	Масштабируйте до реальных размеров
export_uv	логическое значение	Необязательно	правда	UV элемент управления развертыванием
export_orientation	строка	Необязательно	`+x`	Экспортная ориентация. Доступные значения: `-x`, `-y`, `+y`.
quad	логическое значение	Необязательно	false	Только `P2-20260801`. Выводит quad-меш вместо треугольников. Формат вывода принудительно `FBX`; без `face_limit` по умолчанию 10 000 граней.

Примечания к export_orientation:

Применяется только к этой генерации. Если модель будет использоваться в задачах постобработки (текстура, риг, ретаргет, конвертация и т. д.), рекомендуется не задавать этот параметр.
Если параметр задан, постобработка может повлиять на конечный результат из-за неправильной ориентации модели, при этом задача по-прежнему сообщает status: success — ошибка не возникает. Используйте с осторожностью.
Если вы планируете постобработку модели, оставьте этот параметр незаданным и преобразуйте ориентацию на последнем шаге через /v3/models/convert.

Пример

JSON

{
  "inputs": [
    "https://example.com/front.png",
    "https://example.com/back.png",
    "https://example.com/left.png",
    "https://example.com/right.png"
  ],
  "model": "P1-20260311",
  "face_limit": 5000,
  "texture": true
}

P2-20260801 с выводом quad:

JSON

{
  "inputs": [
    "https://example.com/front.png",
    "https://example.com/back.png",
    "https://example.com/left.png",
    "https://example.com/right.png"
  ],
  "model": "P2-20260801",
  "quad": true,
  "face_limit": 8000,
  "texture": true
}