API de Remallado

El ID de la tarea completada de Imagen a 3D o Texto a 3D que deseas remallar. Esta tarea debe ser una de las siguientes tareas: Vista previa de Texto a 3D, Refinamiento de Texto a 3D, Imagen a 3D o Retexturizar. Además, debe tener un estado de SUCCEEDED.

Proporciona un modelo 3D para que Meshy lo remalle mediante una URL de acceso público o un Data URI. Formatos compatibles: .glb, .gltf, .obj, .fbx, .stl.

Para Data URI, usa el MIME type: application/octet-stream.

Una lista de formatos de destino para el modelo remallado. Cuando se omite, solo se genera GLB.

Valores disponibles: glb, fbx, obj, usdz, blend, stl, 3mf.

Especifica la topology del modelo generado.

Valores disponibles:

• quad: Genera una malla predominantemente de cuadrángulos.
• triangle: Genera una malla triangular decimada.

Especifica el número objetivo de polígonos en el modelo generado. El número real de polígonos puede desviarse del objetivo según la complejidad de la geometría.

El rango de valores válido varía según el nivel de usuario:

• De 100 a 300,000 (inclusive)

Habilita la decimación adaptativa estableciendo un nivel de recuento de polígonos. Cuando se establece, se ignora target_polycount.

Valores disponibles:

• 1: Adaptativo — recuento de polígonos ultra.
• 2: Adaptativo — recuento de polígonos alto.
• 3: Adaptativo — recuento de polígonos medio.
• 4: Adaptativo — recuento de polígonos bajo.

Redimensiona el modelo a una altura determinada medida en metros. Recomendamos usar la API de Redimensionar dedicada en su lugar.

Redimensiona el modelo para que la dimensión más larga de la caja delimitadora sea igual al valor especificado en metros. Recomendamos usar la API de Redimensionar dedicada en su lugar.

Cuando se establece en true, el servicio utiliza visión de IA para estimar automáticamente la altura real del objeto y redimensionar el modelo en consecuencia. Recomendamos usar la API de Redimensionar dedicada en su lugar.

Si es true, el servicio solo cambiará el formato del archivo del modelo de entrada, ignorando otras entradas como topology, resize_height y target_polycount. Recomendamos usar la API de Convertir dedicada en su lugar.

Cuando se establece en true, la tarea renderiza además una versión con fondo transparente (RGBA) de la vista previa y la devuelve como alpha_thumbnail_url en la respuesta GET. El campo thumbnail_url existente no cambia.

La solicitud no era aceptable. Causas comunes:

• Parámetro faltante: Se debe proporcionar model_url o input_task_id.
• Tarea de entrada no válida: El input_task_id debe hacer referencia a una tarea exitosa de un modelo compatible.
• Formato de modelo no válido: El model_url apunta a un archivo con una extensión no compatible.
• URL inaccesible: El model_url no se pudo descargar.
• Topology no válida: El parámetro topology no es válido.
• Parámetros mutuamente excluyentes: auto_size y resize_height no pueden establecerse ambos.

La autenticación falló. Comprueba tu clave de API.

Créditos insuficientes para realizar esta tarea.

Has excedido tu límite de tasa.

El ID de la tarea de remallado (remesh) que se va a recuperar.

El ID de la tarea de remallado (remesh) que se va a eliminar.

Número de página para la paginación.

Límite de tamaño de página. El máximo permitido es de 50 elementos.

Campo por el que ordenar.

Valores disponibles:

• +created_at: Ordenar por hora de creación en orden ascendente.
• -created_at: Ordenar por hora de creación en orden descendente.

Identificador único de la tarea de Remallado que se va a transmitir.

Identificador único de la tarea. Aunque usamos un UUID ordenable por clave k para los id de tarea como detalle de implementación, no debes hacer suposiciones sobre el formato del id.

Tipo de la tarea de Remallado. El valor es remesh.

URL descargable del archivo del modelo 3D con textura generado por Meshy. La propiedad de un formato se omitirá si el formato no se genera, en lugar de devolver una cadena vacía.

URL descargable de una imagen de vista previa renderizada a partir del modelo remallado.

URL descargable de una versión con fondo transparente (RGBA) de thumbnail_url. Solo está presente cuando la tarea se creó con alpha_thumbnail: true y la vista previa transparente se renderizó correctamente; de lo contrario, este campo se omite.

progress de la tarea. Si la tarea aún no ha comenzado, esta propiedad será 0. Una vez que la tarea se haya completado correctamente, pasará a ser 100.

Estado de la tarea. Los valores posibles son uno de PENDING, IN_PROGRESS, SUCCEEDED, FAILED.

El número de tareas precedentes.

Marca de tiempo de cuando se creó la tarea, en milisegundos.

Marca de tiempo de cuando se inició la tarea, en milisegundos. Si la tarea aún no ha comenzado, esta propiedad será 0.

Marca de tiempo de cuando finalizó la tarea, en milisegundos. Si la tarea aún no ha finalizado, esta propiedad será 0.

Detalles del error para las tareas fallidas. Consulta Errores para ver la referencia completa del objeto task_error.

El número de créditos consumidos por esta tarea. Está presente cuando el estado de la tarea es PENDING, IN_PROGRESS o SUCCEEDED. Devuelve 0 para las tareas FAILED (los créditos se reembolsan en caso de fallo).