Imagen a modelo 3D: Serie P

POST /v3/generation/image-to-model

Genere un modelo 3D a partir de una imagen 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
input	cadena	Requerido	-	Fuente de la imagen. Acepta file_token, URL o task_id
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)
enable_image_autofix	booleano	Opcional	falso	Se usa para completado por IA y mejora del resultado 3D. Mejora automática de imágenes de entrada de baja calidad
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

{
  "input": "https://example.com/image.png",
  "model": "P1-20260311",
  "face_limit": 5000,
  "texture": true,
  "pbr": true
}

P2-20260801 con salida quad:

JSON

{
  "input": "https://example.com/image.png",
  "model": "P2-20260801",
  "quad": true,
  "face_limit": 8000,
  "texture": true,
  "pbr": true
}