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 de 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 Smart Topology (meshy-t2) no son compatibles.

Cómo se divide el modelo en partes.

Valores disponibles:

• auto: Meshy elige los cortes. prompt se ignora.
• by_parts: Corta siguiendo las partes estructurales que nombres en prompt, como cabeza, brazos y torso.
• by_color: Corta siguiendo 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 produce y se devuelve en model_urls; incluye cualquier otro formato que quieras además.

Valores disponibles: glb, obj, fbx, 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 el modelo de origen las tenía.
• on_plate: Las partes se colocan planas y separadas sobre la placa de impresión, listas para laminar — la misma disposición que la vista On Plate de la aplicación web.

En ambas disposiciones, los archivos exportados contienen un objeto por parte y nada más: una astilla colapsada o una pieza puntual sobrante de un corte se elimina antes de la exportación, de modo que cada objeto que encuentres en el archivo es imprimible.

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

La solicitud no fue aceptable. 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 cobra nada.
• Tarea de entrada no admitida: input_task_id debe referirse a una tarea exitosa de un tipo admitido, generada con Meshy 6 o Meshy 7.
• Entrada con textura: El modelo de entrada tiene texturas. Por ahora solo se admiten modelos sin textura.
• Sin imagen de referencia: by_color requiere una entrada generada a partir de una imagen subida.
• Formato no admitido: 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 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 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 id 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. Cada parte es un objeto independiente dentro del archivo. La propiedad de un formato se omitirá si ese 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 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 en el modelo dividido — una por cada objeto en los archivos exportados. Las astillas 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 ha comenzado, esta propiedad será 0. Una vez que la tarea se haya completado con éxito, esto pasará a 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 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.

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