API de Remallado

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

Proporcione un modelo 3D para que Meshy lo remalle a través de una URL accesible públicamente o un Data URI. Formatos soportados: .glb, .gltf, .obj, .fbx, .stl.

Para Data URIs, use el MIME type: application/octet-stream.

Una lista de formatos objetivo para el modelo remallado. Si se omite, solo se genera GLB.

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

Especifique la topology del modelo generado.

Valores disponibles:

• quad: Generar una malla dominante de quads.
• triangle: Generar una malla de triángulos decimada.

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

El rango de valores válidos varía dependiendo del nivel de usuario:

• 100 a 300,000 (inclusive)

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

Valores disponibles:

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

Redimensionar el modelo a una cierta altura medida en metros. Recomendamos usar el API de Redimensionamiento dedicado en su lugar.

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

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

Si 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 el API de Conversión dedicado en su lugar.

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

La solicitud no fue aceptable. Causas comunes:

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

La autenticación falló. Por favor, verifique su clave de API.

Créditos insuficientes para realizar esta tarea.

Ha excedido su límite de tasa.

El ID de la tarea de remallado a recuperar.

El ID de la tarea de remallado a eliminar.

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

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

Campo por el cual ordenar.

Valores disponibles:

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

Identificador único para la tarea de Remallado a transmitir.

Identificador único para la tarea. Aunque utilizamos un UUID ordenable por k para los ids 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 texturizado generado por Meshy. La propiedad para 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 del modelo remallado.

URL descargable de una versión con fondo transparente (RGBA) de thumbnail_url. Solo presente cuando la tarea fue creada con alpha_thumbnail: true y la vista previa transparente fue renderizada exitosamente; de lo contrario, este campo se omite.

Progreso de la tarea. Si la tarea aún no ha comenzado, esta propiedad será 0. Una vez que la tarea haya tenido éxito, esto se convertirá en 100.

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

El conteo de tareas precedentes.

Marca de tiempo de cuando la tarea fue creada, en milisegundos.

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

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

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

El número de créditos consumidos por esta tarea. Presente cuando el estado de la tarea es PENDING, IN_PROGRESS, o SUCCEEDED. Devuelve 0 para tareas FAILED (los créditos son reembolsados en caso de fallo).