Texto a modelo 3D: Serie P

POST /v3/generation/text-to-model

Genere un modelo 3D a partir de un mensaje de texto utilizando los modelos de la Serie P. La Serie P está optimizada para la mejor generación de baja poli de su clase con una topología limpia y refinada, ideal para recursos de juegos, contenido estilizado y flujos de trabajo 3D livianos.

Diferencias clave con respecto al estándar

Optimizado para salida low-poly (P1-20260311: 50–20 000 caras; P2-20260801: hasta 50 000)
~2s de generación de malla con topología estructurada
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
prompt	cadena	Requerido	-	Mensaje de texto, hasta 1024 caracteres
negative_prompt	cadena	Opcional	-	Mensaje negativo, hasta 255 caracteres
image_seed	entero	Opcional	aleatorio	Semilla aleatoria para la etapa de conversión de texto a imagen
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)
model_seed	entero	Opcional	aleatorio	Semilla aleatoria para la generación de 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 los mapas de materiales PBR. Fuerza la textura = verdadero
texture_seed	entero	Opcional	aleatorio	Semilla aleatoria para generación de 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 (metros)
export_uv	booleano	Opcional	cierto	UV desenvolviendo. false = archivo más rápido y más pequeño
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

{
  "prompt": "a low poly medieval sword",
  "model": "P1-20260311",
  "face_limit": 3000,
  "texture": true,
  "texture_quality": "detailed"
}

P2-20260801 con salida quad:

JSON

{
  "prompt": "a low poly medieval sword",
  "model": "P2-20260801",
  "quad": true,
  "face_limit": 8000,
  "texture": true
}

Respuesta

JSON

{
  "code": 0,
  "data": {
    "task_id": "task_abc123"
  }
}