API de Reparar imprimibilidad

El ID de una tarea exitosa de tu propiedad. Tipos de tarea admitidos: Imagen a 3D, Multi-imagen a 3D, Texto a 3D, Remallado, Retexturizar y Analizar imprimibilidad. La tarea debe tener un estado SUCCEEDED y debe haber producido un asset GLB.

Una tarea de análisis que comprobó el grosor de pared también transmite su impresora y tamaño, por lo que la reparación comprueba el grosor de pared, y engrosa las paredes finas, incluso si no envías ninguno de los dos; un printer_type o un tamaño de impresión que envíes anulará ese valor. Las tareas de análisis creadas a partir de un model_url .stl, .fbx o .gltf no se aceptan: envía el archivo como model_url en su lugar.

URL de un modelo 3D a reparar. Formatos admitidos: .glb, .gltf, .obj, .fbx, .stl. Tamaño máximo de archivo: 100 MB. Debe usar http, https, o una URL data: (las URL data omiten las comprobaciones de extensión).

Las URL de descarga de Meshy (assets.meshy.ai/…?Expires=…&Signature=…) están firmadas y dejan de funcionar al llegar a expires_at de la tarea; volver a consultar la tarea no las renueva. Para un modelo generado con Meshy, pasa input_task_id en su lugar. Funciona mientras la tarea de origen se conserve (consulta Retención de recursos). Para reutilizar un modelo después de eso, descárgalo antes de expires_at y envía tu propia copia.

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 cambia.

La impresora que planeas usar. Establece el grosor de pared mínimo al que apunta la reparación. Por defecto es fdm cuando envías un tamaño de impresión sin indicarlo, a menos que una tarea de análisis pasada como input_task_id proporcione la impresora.

Valores disponibles:

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

Altura de la impresión, en milímetros. Rango: [1, 1000]. Redondeado al milímetro más cercano. Solo para entrada GLB.

Longitud del lado más largo de la impresión, en milímetros. Rango: [1, 1000]. Redondeado al milímetro más cercano. Funciona con cada formato de entrada.

La solicitud era inaceptable. Causas comunes:

• Parámetro faltante: no se proporcionó 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 tiene un formato incorrecto, usa un esquema no compatible, o tiene una extensión de archivo no compatible.
• Archivo de modelo demasiado grande: el cuerpo de model_url superó los 100 MB.
• No se pudo descargar el archivo de modelo: model_url devolvió un error, con mayor frecuencia porque una URL de descarga de Meshy firmada ha caducado. Volver a consultar la tarea devuelve la misma URL con la misma caducidad, así que envía tu propia copia del archivo, o usa input_task_id mientras la tarea de origen aún esté retenida.
• Tarea no exitosa: la tarea referenciada aún está pendiente, en progreso, o falló.
• Falta GLB: la tarea referenciada no tiene ningún asset GLB para reparar.
• Tamaño de impresión inválido: intended_print_height_mm o intended_print_longest_side_mm está fuera de [1, 1000], o se enviaron ambos.
• Tipo de impresora desconocido: printer_type no es fdm, sla, ni full_color.
• Altura en un modelo que no es GLB: se envió intended_print_height_mm con un model_url que no es .glb. Usa intended_print_longest_side_mm en su lugar.
• No se puede dimensionar este modelo por altura: a la altura solicitada (o al valor predeterminado de 150 mm), el lado más largo del modelo quedaría fuera de [1, 1000] mm, el modelo es plano, o no se puede determinar su tamaño. Usa intended_print_longest_side_mm en su lugar. Para un model_url .glb y algunas tareas input_task_id, esto solo se detecta después de que la tarea comienza, y la tarea termina FAILED en su lugar.
• Tamaño de STL inutilizable: se envió printer_type sin un tamaño, y el lado más largo propio del .stl no se puede leer o está fuera de [1, 1000] mm. Envía intended_print_longest_side_mm.

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

Causas comunes:

• Plan gratuito: la creación de tareas requiere un plan de pago. Mejora tu plan en la página de suscripción.
• Créditos insuficientes: se alcanzó el límite de créditos del espacio de trabajo.

La tarea referenciada no existe o pertenece a un usuario diferente.

Has excedido tu cuota de tareas pendientes o tu límite de tasa.

El ID de la tarea de reparación de imprimibilidad que se desea recuperar.

El ID de la tarea de reparar imprimibilidad que se va a eliminar.

Número de página para la paginación. Comienza y por defecto es 1.

Límite de tamaño de página. Por defecto es 10 elementos. 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 reparar imprimibilidad que se va a 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 ninguna suposición sobre el formato del id.

Tipo de la tarea de reparar imprimibilidad. El valor es print-repair.

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

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

El recuento 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 ha comenzado, 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.

Marca de tiempo de cuándo el resultado de la tarea caducará en el sistema, en milisegundos. 0 si la tarea aún no ha finalizado.

Información del error si la tarea ha fallado. Esta propiedad es null si la tarea no ha fallado. Consulta Errores para más detalles.

URLs descargables del modelo 3D reparado. Solo se rellena el campo que coincide con el formato de entrada; los campos de los demás formatos quedan como cadenas vacías.

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

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.

Siempre es un array vacío. La reparación conserva únicamente la geometría de entrada y no vuelve a generar las texturas.

El número de créditos consumidos por esta tarea. 10 una vez que la tarea ha alcanzado SUCCEEDED. Devuelve 0 para las tareas FAILED (los créditos se reembolsan en caso de fallo).

La impresora y el tamaño que usó la reparación, ya sea enviados o reutilizados de una tarea de análisis. Presente en una reparación de grosor de pared desde el inicio (PENDING); los valores aún no conocidos son null.

Lo que hizo la reparación de grosor de pared. Presente una vez que una reparación de grosor de pared ha tenido éxito.