API de Analizar imprimibilidad

Obligatorio a menos que envíes model_url. El ID de la tarea cuyo modelo quieres analizar. La tarea debe tener el estado SUCCEEDED y ser tuya o estar en un espacio de trabajo al que pertenezcas.

Puede ser uno de estos tipos de tarea, usando Meshy 6 o una versión más reciente, incluido Meshy 7:

• Imagen a 3D
• Multi-imagen a 3D
• Texto a 3D
• Remallado
• Retexturizar

Una tarea de Reparar imprimibilidad también funciona.

Obligatorio a menos que envíes input_task_id. El modelo a analizar, como una URL pública o un data URI. Si envías ambos, Meshy usa input_task_id.

Desde una URL http o https, el modelo debe ser un archivo .glb, .gltf, .obj, .fbx o .stl de como máximo 400 MB. Un data URI solo puede contener un archivo GLB en base64 (data:model/gltf-binary;base64,...) o glTF (data:model/gltf+json;base64,...) de como máximo 100 MB. Envía un archivo .obj, .fbx o .stl como una URL http o https.

Un archivo de más de 100 MB también debe cumplir estas reglas:

• Un archivo GLB, glTF, FBX u OBJ puede tener como máximo 10 000 000 de caras. Meshy cuenta las caras como triángulos, por lo que un cuadrilátero cuenta como 2, y una malla dibujada más de una vez cuenta una vez por copia.
• Un archivo FBX debe ser FBX binario 7.1 o más reciente.
• Un archivo GLB o glTF no debe usar compresión Draco.

Una URL de descarga de Meshy (assets.meshy.ai/…?Expires=…&Signature=…) está firmada y deja de funcionar en el expires_at de su tarea. Volver a leer la tarea no la renueva. Para un modelo que creaste con Meshy, envía input_task_id en su lugar, que funciona mientras Meshy conserve la tarea de origen (consulta Retención de recursos). Para usar el modelo después de eso, descárgalo antes de expires_at y envía tu propia copia.

La impresora que planeas usar. Establece el grosor de pared mínimo para la comprobación de grosor de pared. Si envías un tamaño de impresión sin printer_type, Meshy usa fdm.

Valores disponibles:

• fdm: filamento, grosor de pared mínimo de 1.0 mm
• sla: resina, grosor de pared mínimo de 0.8 mm
• full_color: color completo, grosor de pared mínimo de 2.0 mm

Cualquier otro valor devuelve 400.

La altura de la impresión, en milímetros, de 1 a 1000. Un valor fuera de ese rango devuelve 400. Envía este parámetro o intended_print_longest_side_mm, no ambos.

Solo funciona con entrada en GLB. Para un model_url que no sea un archivo .glb, envía intended_print_longest_side_mm en su lugar.

La longitud del lado más largo de la impresión, en milímetros, de 1 a 1000. Un valor fuera de ese rango devuelve 400. Funciona con todos los formatos de entrada.

La solicitud no se puede ejecutar. El mensaje de error indica qué problema encontró. Por ejemplo:

• Parámetro faltante: no se envió ni input_task_id ni model_url.
• UUID inválido: input_task_id no es un UUID válido.
• URL de modelo inválida: model_url está mal formada, usa un esquema no compatible o tiene una extensión de archivo no compatible.
• Archivo de modelo demasiado grande: el archivo de model_url supera los 400 MB desde una URL http o https, o supera los 100 MB como data URI.
• Demasiadas caras: el archivo de model_url es un archivo GLB, glTF, FBX u OBJ de más de 100 MB con más de 10 000 000 de caras. Reduce el número de caras y envía el archivo nuevamente.
• FBX ASCII de más de 100 MB: el archivo de model_url es un FBX ASCII de más de 100 MB. Envíalo como FBX binario o GLB.
• Archivo de modelo ilegible: el archivo de model_url tiene más de 100 MB y Meshy no puede leer su encabezado. Por ejemplo, es un GLB o glTF comprimido con Draco, o un FBX binario anterior a 7.1.
• Encabezado del modelo demasiado complejo: el archivo de model_url tiene más de 100 MB y su encabezado tiene demasiadas mallas, nodos o registros para comprobar. Reduce el número de objetos en el archivo y envíalo nuevamente.
• El archivo de modelo no se puede descargar: model_url devolvió un error, casi siempre porque una URL de descarga firmada de Meshy caducó. Volver a leer la tarea devuelve la misma URL con la misma caducidad. Envía tu propia copia del archivo, o envía input_task_id mientras Meshy conserve la tarea de origen.
• Tarea no completada: la tarea de input_task_id sigue pendiente, en curso o falló.
• Tamaño de impresión inválido: intended_print_height_mm o intended_print_longest_side_mm está fuera del rango de 1 a 1000, o la solicitud tiene ambos.
• Tipo de impresora desconocido: printer_type no es fdm, sla ni full_color.
• Altura en un modelo que no es GLB: la solicitud tiene intended_print_height_mm y un model_url que no es un archivo .glb. Envía intended_print_longest_side_mm en su lugar.
• No se puede dimensionar este modelo por altura: con la altura solicitada, o el valor predeterminado de 150 mm, el lado más largo del modelo quedaría fuera del rango de 1 a 1000 mm. También ocurre cuando el modelo es plano, o cuando Meshy no puede determinar su tamaño. Envía intended_print_longest_side_mm en su lugar. Para un model_url .glb y algunas tareas de input_task_id, Meshy solo descubre esto después de que la tarea comienza, y la tarea termina como FAILED en su lugar.
• Tamaño STL inutilizable: la solicitud tiene printer_type sin un tamaño, y Meshy no puede leer el lado más largo propio del archivo .stl, o está fuera del rango de 1 a 1000 mm. Envía intended_print_longest_side_mm.

Corrige la solicitud y envíala de nuevo. Consulta Errores.

Falta la clave de API o no es válida. Verifica el encabezado Authorization.

input_task_id es un modelo de bajorrelieve, que este endpoint no puede analizar. El mensaje es This model type does not support this operation. Envía un modelo diferente.

Meshy no puede encontrar un modelo para analizar para input_task_id. Por ejemplo:

• La tarea no existe, fue eliminada, o no es tuya ni está en un espacio de trabajo al que pertenezcas.
• La tarea usa un modelo anterior a Meshy 6, o su tipo no produce un modelo 3D.
• El archivo de modelo de la tarea ya no está en el almacenamiento.

Comprueba que input_task_id sea una tarea compatible que sea tuya o esté en uno de tus espacios de trabajo, o envía el modelo como model_url.

Superaste tu límite de tasa, o tienes demasiadas tareas pendientes. Espera y vuelve a intentarlo. Consulta Límites de tasa.

El ID de la tarea de la respuesta de creación.

El ID de la tarea que se va a eliminar.

El número de página a devolver, comenzando en 1.

El número de tareas por página, hasta 100.

El orden de clasificación.

Valores disponibles:

• +created_at: más antiguas primero
• -created_at: más recientes primero

El ID de la tarea de la respuesta de creación.

El ID de la tarea. Trátelo como una cadena opaca y no dependa de su formato.

El tipo de tarea, siempre print-analyze.

El estado de la tarea, uno de PENDING, IN_PROGRESS, SUCCEEDED, FAILED o CANCELED.

Cuánto de la tarea se ha completado, como porcentaje. Es 0 hasta que la tarea comienza y 100 cuando tiene éxito.

La cantidad de tareas por delante de esta en la cola. El valor solo es significativo mientras la tarea está en PENDING.

Hora en que se creó la tarea, en milisegundos Unix.

Hora en que comenzó la tarea, en milisegundos Unix. Es 0 hasta que la tarea comienza.

Hora en que finalizó la tarea, en milisegundos Unix. Es 0 hasta que la tarea finaliza.

Hora en que expira el resultado de la tarea, en milisegundos Unix. Es 0 hasta que la tarea finaliza.

Los detalles del error cuando la tarea falla. Es null si la tarea no ha fallado. Consulte Errores.

El resultado del análisis. No está presente hasta que la tarea está en SUCCEEDED.

El número de créditos que usó la tarea. Siempre es 0, porque el análisis es gratuito.