Vista múltiple a modelo 3D: Serie P

POST /v3/generation/multiview-to-model

Genere un modelo 3D a partir de imágenes de vista múltiple utilizando los modelos de la Serie P. Optimizado para generación de baja poli con topología limpia.

Diferencias clave con respecto al estándar

Optimizado para salida low-poly (P1-20260311: 50–20 000 caras; P2-20260801: hasta 50 000)
quad solo es compatible con P2-20260801; smart_low_poly, generate_parts y geometry_quality no son compatibles.

Solicitar parámetros

Parámetro	Tipo	Requerido	Predeterminado	Descripción
inputs	cadena []	Requerido	-	Lista de 4 imágenes multivista [frontal, izquierda, trasera, derecha]
original_task_id	cadena	Opcional	-	Tarea ID de la generación anterior de vistas múltiples. Mutuamente excluyentes con entradas
model	cadena	Requerido	-	Versión del modelo Serie P. Debe indicarse para llamar a la Serie P; si se omite, la solicitud se ejecuta con el modelo predeterminado de la Serie H, `v3.1-20260211`. Valores: `P1-20260311` (optimizado para low-poly), `P2-20260801` (nueva generación, admite salida quad; vista previa)
texture_alignment	cadena	Opcional	original_image	`original_image` o `geometry`
orientation	cadena	Opcional	predeterminado	`default` o `align_image`
model_seed	entero	Opcional	aleatorio	Semilla aleatoria para geometría
face_limit	entero	Opcional	adaptativo	Número máximo de polígonos. `P1-20260311`: 50–20 000; `P2-20260801` triángulos: 48–50 000, con `quad=true`: 48–25 000
texture	booleano	Opcional	cierto	Habilitar mapas de textura
pbr	booleano	Opcional	cierto	Habilite PBR. Fuerza la textura = verdadero
texture_seed	entero	Opcional	aleatorio	Semilla aleatoria para textura
texture_quality	cadena	Opcional	estándar	`fast` (requiere `texture_version=v3.5-20260815`), `standard`, `detailed` o `extreme`
texture_version	cadena	Opcional	Derivado de model	Fija el modelo de textura: `v3.5-20260815`, `v3.0-20250812` o `v2.5-20250123`. Para geometría de la serie P, el valor predeterminado es `v3.0-20250812`
delight	booleano	Opcional	true	Elimina la iluminación incrustada de la imagen de referencia antes de texturizar. Solo se aplica cuando `texture_version=v3.5-20260815`
auto_size	booleano	Opcional	falso	Escalar a dimensiones del mundo real
export_uv	booleano	Opcional	cierto	Control de desenrollado UV
export_orientation	cadena	Opcional	`+x`	Orientación exportadora. Valores disponibles: `-x`, `-y`, `+y`
quad	booleano	Opcional	false	Solo `P2-20260801`. Genera una malla quad en lugar de triángulos. Fuerza el formato de salida a `FBX`; si no se define `face_limit`, se usan 10 000 caras de forma predeterminada.

Notas sobre export_orientation:

Se aplica solo a esta generación. Si el modelo se va a usar en tareas de postprocesamiento (textura, rig, reorientación, conversión, …), se recomienda no establecer este parámetro.
Si se establece, el postprocesamiento puede afectar el resultado final debido a una orientación incorrecta del modelo, aunque la tarea siga informando status: success — no se genera ningún error. Úselo con precaución.
Si planea postprocesar el modelo, deje este parámetro sin definir y convierta la orientación en el último paso mediante /v3/models/convert.

Ejemplo

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 con salida 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
}