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: Text to 3D Preview, Text to 3D Refine, Imagen a 3D o Retexturizar. Además, debe tener un estado SUCCEEDED.

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

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

Una lista de formatos de destino para el modelo remallado. Si 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 cuádruple.
• triangle: Genera una malla de triángulos decimada.

Especifica el número objetivo de polígonos en el modelo generado. El número real de polígonos puede variar respecto al 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 configurando un nivel de recuento de polígonos. Cuando se establece, target_polycount se ignora.

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 de modo que la dimensión más larga de su bounding box 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 artificial para estimar automáticamente la altura real del objeto en el mundo real 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 además renderiza 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 se modifica.

La solicitud fue inaceptable. Causas comunes:

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

Falló la autenticación. Por favor, verifica tu clave de API.

Créditos insuficientes para realizar esta tarea.

Has superado tu 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 100 elementos.

Campo por el cual 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 desea transmitir.

Identificador único de la tarea. Aunque usamos un UUID k-sortable para los ids de tareas 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 dicho formato no se generó, 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.

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

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

La cantidad de tareas precedentes.

Marca de tiempo de cuándo se creó la tarea, en milisegundos.

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

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

Detalles del error para tareas fallidas. Consulta Errores para ver 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 se reembolsan en caso de fallo).