API de Auto Split

El ID de una tarea completada cuyo modelo se va a dividir. Tipos de tarea admitidos: Imagen a 3D, Multi-imagen a 3D, Texto a 3D (vista previa), Remallado, Convertir y Redimensionar. La tarea debe tener el estado SUCCEEDED, y su modelo debe haberse generado con Meshy 6 o Meshy 7 (ai_model meshy-6, meshy-7, meshy-7.1 o latest). Los modelos low-poly y de Smart Topology (meshy-t2) no son compatibles. Se acepta un modelo con textura, pero su textura no se traslada al resultado.

Cómo se divide el modelo en partes.

Valores disponibles:

• auto: Meshy elige los cortes. Se ignora prompt.
• by_parts: Corta según las partes estructurales que indiques en prompt, como cabeza, brazos y torso.
• by_color: Corta según las regiones de color que indiques en prompt. Requiere una entrada generada a partir de una imagen subida (Imagen a 3D o Multi-imagen a 3D); otras entradas se rechazan con 400. Los límites de las regiones de color provienen de la imagen de origen, no de la textura del modelo de entrada. Para Multi-imagen a 3D, Auto Split usa la primera imagen de origen.

Formatos en los que exportar el modelo dividido. Los formatos que admiten objetos de escena (glb, obj, fbx, usdz, blend, 3mf) llevan cada parte como un objeto independiente; stl no tiene noción de objetos independientes, así que fusiona todas las partes en un solo sólido dispuesto según layout (solicita 3mf para obtener partes seleccionables por separado en un laminador). glb siempre se genera y se devuelve en model_urls; incluye cualquier otro formato adicional que desees.

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

Cómo se disponen las partes en cada formato de salida y en la miniatura.

Valores disponibles:

• assembled: Las partes permanecen donde estaban en el modelo de origen.
• on_plate: Las partes se colocan planas y distribuidas sobre la plataforma de impresión, listas para laminar — la misma disposición que la vista On Plate de la aplicación web.

En ambas disposiciones, se elimina antes de exportar cualquier fragmento colapsado o similar a un punto que quede de un corte, de modo que cada parte que obtengas sea imprimible. Los formatos que admiten objetos de escena mantienen un objeto por parte; stl los fusiona en un solo sólido.

Añade conectores de espiga y muesca en cada corte para que las partes impresas encajen entre sí.

La solicitud fue inaceptable. Causas comunes:

• Falta el prompt: prompt es obligatorio cuando mode es by_parts o by_color.
• El prompt no describe ninguna división, o describe demasiadas partes: by_parts / by_color acepta de 1 a 10 piezas nombradas. Se rechaza una descripción que pide mantener el modelo en una sola pieza, o que nombra más de 10 partes. No se cobra nada.
• Tarea de entrada no admitida: input_task_id debe referirse a una tarea completada de un tipo admitido, generada con Meshy 6 o Meshy 7.
• Sin imagen de referencia: by_color requiere una entrada generada a partir de una imagen subida.
• Conector fuera de rango: connector_size o connector_height está fuera del rango 0.1 a 0.8.

Error de autenticación. Verifica tu clave de API.

Créditos insuficientes para realizar esta tarea.

El input_task_id no existe o no pertenece a tu cuenta.

Has superado tu límite de tasa. Las solicitudes by_parts y by_color también comparten un límite de análisis de prompt de 12 solicitudes por minuto por cuenta.

La división basada en prompt (by_parts y by_color) no está disponible temporalmente. Vuelve a intentarlo más tarde, o usa mode: "auto", que no se ve afectado. No se cobra nada.

El ID de la tarea de Auto Split que se desea recuperar.

El ID de la tarea de Auto Split que se eliminará.

Número de página para la paginación. Comienza y tiene como valor predeterminado 1.

Límite de tamaño de página. El valor predeterminado es 10 elementos. El máximo permitido es 100 elementos; valores mayores se ajustan a 100.

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 Auto Split que se va a transmitir.

Identificador único de la tarea. Aunque usamos un UUID k-sortable para los ids de tarea como detalle de implementación, no debes hacer ninguna suposición sobre el formato del id.

Tipo de la tarea. El valor es print-split.

URLs descargables del modelo dividido, una por cada formato solicitado. Los formatos que admiten objetos de escena mantienen cada parte como un objeto independiente; stl las fusiona en un solo sólido. La propiedad de un formato se omitirá si dicho formato no fue solicitado.

URL descargable de una vista previa renderizada del modelo dividido, con cada parte en un color distinto, en el layout solicitado.

true cuando el prompt de una solicitud by_parts o by_color no nombró ninguna parte, por lo que Meshy dividió el modelo automáticamente en su lugar; los nombres de las partes en el resultado son los de Meshy, no los tuyos. Presente desde PENDING en adelante. Se omite para tareas auto y siempre que se haya seguido el prompt.

Número de partes imprimibles que produjo la división. Los formatos que admiten objetos de escena incluyen un objeto por parte; stl las fusiona en un solo sólido, y el recuento sigue reportando las partes. Las esquirlas colapsadas que la segmentación no pudo convertir en una pieza imprimible se eliminan de los archivos antes de la exportación y no se cuentan.

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

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

El número 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 la referencia completa del objeto task_error.

El número de créditos consumidos por esta tarea. Siempre presente: 10 una vez que la tarea ha sido aceptada, y 0 para tareas FAILED porque el cargo se reembolsa en caso de fallo. Eliminar una tarea mientras aún está en PENDING también la reembolsa.