API de Auto Split

El ID de una tarea con estado SUCCEEDED 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 un 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). No se admiten modelos low-poly ni de Smart Topology (meshy-t2, meshy-t2.5). 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 nombres en prompt, como cabeza, brazos y torso.
• by_color: Corta según las regiones de color que nombres 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 separados, así que fusiona todas las partes en un único sólido dispuesto según layout (solicita 3mf para obtener partes seleccionables por separado en un laminador). glb siempre se produce y se devuelve en model_urls; indica 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 las tenía 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, cualquier fragmento colapsado o pieza parecida a un punto que quede de un corte se elimina antes de exportar, de modo que cada parte que obtienes es imprimible. Los formatos que admiten objetos de escena contienen un objeto por parte; stl los fusiona en un único sólido.

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

La solicitud no era aceptable. Causas comunes:

• Falta el prompt: prompt es obligatorio cuando mode es by_parts o by_color.
• El prompt no describe ninguna división, o nombra demasiadas partes: by_parts / by_color acepta de 1 a 10 piezas nombradas. Se rechaza una descripción que pida mantener el modelo en una sola pieza, o que nombre más de 10 partes. No se cobra nada.
• Tarea de entrada no admitida: input_task_id debe referirse a una tarea con estado SUCCEEDED 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 de 0.1 a 0.8.

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

Créditos insuficientes para realizar esta tarea.

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 a eliminar.

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

Límite del tamaño de página. El valor predeterminado es 10 elementos. El máximo permitido es 100 elementos; los valores mayores se limitan 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 desea transmitir.

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

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

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

URL descargable a 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 de Meshy, no los tuyos. Presente desde PENDING en adelante. Se omite en las 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 llevan un objeto por cada parte; stl las fusiona en un único sólido, y el recuento sigue reportando las partes. Las fracciones 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.

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, se convertirá en 100.

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

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.

Detalles del error para tareas fallidas. Consulta Errores para la referencia completa del objeto task_error. Si la comprobación de seguridad del proveedor del modelo rechaza el modelo de entrada, la tarea falla con task_error.type invalid_input y code provider_content_refused. Consulta Errores.

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 todavía está PENDING también la reembolsa.