API de Auto Split

El ID de una tarea exitosa 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, o latest). Los modelos low-poly y de Smart Topology (meshy-t2) no son compatibles.

Cómo se divide el modelo en partes.

Valores disponibles:

• auto: Meshy elige los cortes. Se ignora prompt.
• by_parts: Corta a lo largo de las partes estructurales que nombres en prompt, como cabeza, brazos y torso.
• by_color: Corta a lo largo de 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.

Formatos en los que exportar el modelo dividido. Cada parte es un objeto separado en cada formato. glb siempre se genera y se devuelve en model_urls; incluye en la lista cualquier otro formato adicional que quieras.

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

3mf se genera pensando en los laminadores: un objeto por parte, cada uno en su propia ranura de filamento, de modo que Bambu Studio abre el archivo como partes de colores individuales y seleccionables por separado (el archivo incluye una configuración de proyecto de Bambu Studio; otros laminadores leen la geometría). Al igual que los demás formatos de impresión de Meshy, está en milímetros y, dado que este endpoint no admite un tamaño objetivo, todo el modelo se escala de modo que su lado más largo mida 150 mm — el mismo límite que usan las demás exportaciones en formato de impresión, elegido para encajar en cualquier plataforma de impresión convencional. Con layout: "on_plate", el límite se aplica a la plataforma con el diseño en conjunto, de modo que el archivo queda listo para laminar; con assembled, las partes se colocan donde estaban en el modelo original y tú las organizas en el laminador.

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

Valores disponibles:

• assembled: Las partes permanecen donde estaban en el modelo original.
• 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 ambos diseños, los archivos exportados contienen un objeto por parte y nada más: una porción colapsada o una pieza semejante a un punto que quede de un corte se elimina antes de la exportación, de modo que cada objeto que encuentres en el archivo es imprimible.

Agrega conectores de tipo 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 nombra menos de dos partes: by_parts / by_color necesita al menos dos piezas nombradas (por ejemplo head, torso, base); una instrucción genérica como split into individual parts se rechaza. No se realiza ningún cobro.
• Tarea de entrada no compatible: input_task_id debe hacer referencia a una tarea exitosa de un tipo compatible, generada con Meshy 6 o Meshy 7.
• Entrada con texturas: El modelo de entrada tiene texturas. Por ahora solo se admiten modelos sin texturas.
• Sin imagen de referencia: by_color requiere una entrada generada a partir de una imagen subida.
• Formato no compatible: target_formats contiene stl.
• Conector fuera de rango: connector_size o connector_height está fuera de 0.1 a 0.8.

Falló la autenticación. Por favor, 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 excedido tu límite de tasa. Las solicitudes by_parts y by_color también comparten un límite de análisis de prompts de 12 solicitudes por minuto y 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 realiza ningún cobro.

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

El ID de la tarea de Auto Split que se va a eliminar.

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

Límite del tamaño de página. Por defecto es 10 elementos. El máximo permitido es 100 elementos; los valores mayores se limitan a 100.

Campo por el que 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 debe asumir nada sobre el formato del id.

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

URLs descargables al modelo dividido, una por cada formato solicitado. Cada parte es un objeto independiente dentro del archivo. La propiedad de un formato se omitirá si dicho 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 los de Meshy, no los suyos. Presente desde PENDING en adelante. Se omite en las tareas auto y siempre que se haya seguido el prompt.

Número de partes imprimibles en el modelo dividido: una por cada objeto en los archivos exportados. Los fragmentos colapsados 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 se ha iniciado, 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, 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 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. Consulte 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á PENDING también la reembolsa.