Auto Split API

El ID de la tarea cuyo modelo se va a dividir. La tarea debe tener el estado SUCCEEDED. Estos tipos de tareas funcionan:

• Imagen a 3D
• Multi-imagen a 3D
• Texto a 3D, una tarea preview o refine
• Retexturizar
• Remallado
• Convertir
• Redimensionar

El modelo debe haberse generado con Meshy 6 o Meshy 7, es decir, con ai_model establecido en meshy-6-lite, meshy-6, meshy-7, meshy-7.1, o latest. Los modelos Smart Topology (meshy-t2 y meshy-t2.5) no son compatibles. Para una tarea de refine, Retexturizar, Remallado, Convertir o Redimensionar, la regla se aplica al modelo del que partió la tarea. Una tarea de Retexturizar, Remallado, Convertir o Redimensionar creada a partir de un modelo subido devuelve 400.

El modelo puede tener como máximo 8.000.000 de caras. Un modelo con más caras devuelve 400. En ese caso, ejecuta primero una tarea de Remallado sobre él y envía el ID de esa tarea en su lugar.

Puedes dividir un modelo con textura. Para conservar su textura en las partes, envía keep_texture: true.

Cómo dividir el modelo en partes.

Valores disponibles:

• auto: Meshy elige los cortes e ignora prompt. Un prompt de más de 600 caracteres sigue devolviendo 400.
• by_parts: Meshy corta siguiendo las partes estructurales que nombres en prompt, por ejemplo cabeza, brazos y torso.
• by_color: Meshy corta siguiendo las regiones de color que nombres en prompt. Meshy encuentra las regiones en la imagen de origen, no en la textura del modelo de entrada. La entrada debe generarse a partir de una imagen subida, con Imagen a 3D o Multi-imagen a 3D. Otras entradas devuelven 400. Para Multi-imagen a 3D, Meshy usa la primera imagen de origen.

Los formatos de archivo a generar. Meshy siempre genera glb y lo devuelve en model_urls, además de los otros formatos que indiques.

Valores disponibles:

• glb
• obj
• fbx
• stl
• usdz
• blend
• 3mf

Todos los formatos excepto stl admiten objetos de escena y mantienen cada parte como un objeto independiente. Un archivo STL no puede contener objetos independientes, así que Meshy fusiona las partes en un solo sólido, organizado según layout. Para obtener partes que puedas seleccionar por separado en un laminador, solicita 3mf.

Con keep_texture: true, estos formatos conservan la textura:

• glb, fbx, usdz, y blend: La textura está dentro del archivo.
• obj: La textura está en el archivo de material, que model_urls devuelve bajo mtl.
• stl y 3mf: El archivo solo contiene geometría, sin la textura.

Cómo organiza Meshy las partes, en todos los formatos de archivo y en la miniatura.

Valores disponibles:

• assembled: Meshy mantiene las partes donde estaban en el modelo de origen.
• on_plate: Meshy coloca las partes planas y las distribuye sobre la bandeja de impresión, listas para laminar. Esta es la misma disposición que la vista On Plate en la aplicación web.

En ambas disposiciones, Meshy elimina cualquier fragmento colapsado o parecido a un punto que un corte pueda dejar antes de exportar, de modo que todas las partes que obtengas sean imprimibles. Los formatos que admiten objetos de escena mantienen un objeto por parte, y stl fusiona las partes en un solo sólido.

Si se debe conservar la textura del modelo de entrada en las partes. true da a cada parte la textura de la entrada, y la tarea devuelve los mapas en texture_urls. false da a cada parte un color de vértice plano.

Con true, la tarea tarda aproximadamente el doble, y el costo en créditos no cambia. Una entrada sin textura se divide igual que con false. Si Meshy no puede conservar la textura, la tarea falla con el código de error textured_split_refused. Consulta Errores.

Si se deben añadir conectores de espiga y mortaja en cada corte, para que las partes impresas encajen entre sí.

La solicitud no se puede ejecutar. El mensaje de error indica qué problema encontró. Por ejemplo:

• Falta el prompt: mode es by_parts o by_color, y falta prompt.
• El prompt no describe ninguna división, o nombra demasiadas partes: El prompt pide mantener el modelo en una sola pieza, o nombra más de 10 partes. by_parts y by_color aceptan de 1 a 10 partes nombradas. Meshy no cobra por la solicitud.
• Tarea de entrada no compatible: input_task_id no es una tarea completada con éxito de un tipo compatible, generada con Meshy 6 o Meshy 7.
• Sin imagen de referencia: mode es by_color, y la entrada no se generó a partir de una imagen subida.
• Conector fuera de rango: connector_size o connector_height está fuera de 0.1 a 0.8.

Corrige la solicitud y envíala de nuevo. Consulta Errores.

Falta la clave de API o no es válida. Verifica el encabezado Authorization.

Por ejemplo:

• Créditos insuficientes: La cuenta no tiene suficientes créditos para esta tarea, o la cuenta alcanzó un límite de créditos. Revisa tu saldo de créditos y vuelve a intentarlo.
• Plan gratuito: Crear una tarea requiere un plan de pago. Actualiza tu plan en la configuración de tu suscripción y vuelve a intentarlo.

Se aplica uno de estos casos:

• La moderación de contenido bloqueó el prompt. El mensaje es explicit content o prohibited content. Cambia el prompt y vuelve a intentarlo.
• input_task_id es un modelo de bajorrelieve, que este endpoint no puede dividir. El mensaje es This model type does not support this operation. Envía un modelo diferente.

input_task_id no existe o no pertenece a tu cuenta. Verifica el ID y usa una clave de API de la cuenta que creó la tarea.

Excediste tu límite de tasa. Espera y vuelve a intentarlo. Consulta Límites de tasa.

Las solicitudes by_parts y by_color también comparten un límite de lectura de prompts de 12 solicitudes por minuto por cuenta.

La división por prompt (by_parts y by_color) no está disponible temporalmente. Vuelve a intentarlo más tarde, o envía mode: "auto", que sigue funcionando. Meshy no cobra por la solicitud.

El ID de la tarea de la respuesta de creación.

El ID de la tarea a eliminar.

El número de página a devolver. Comienza en 1 y ese es el valor predeterminado.

El número de tareas por página, hasta 100. El valor predeterminado es 10. Meshy trata un valor mayor como 100.

El orden de clasificación.

Valores disponibles:

• +created_at: más antiguas primero
• -created_at: más recientes primero

El ID de la tarea proveniente de la respuesta de creación.

El ID de la tarea. Trátelo como una cadena opaca y no dependa de su formato.

El tipo de tarea, siempre print-split.

URLs de descarga para el modelo dividido, una por cada formato que solicitó. Un formato que no solicitó no tiene clave. Los formatos que admiten objetos de escena mantienen cada parte como un objeto separado, y stl fusiona las partes en un único sólido.

URL de descarga para una imagen de vista previa del modelo dividido, en el layout que solicitó. Cuando las partes conservan una textura, la vista previa la muestra. De lo contrario, cada parte tiene su propio color.

Los mapas de textura del modelo dividido, como un array con un objeto. Todas las partes comparten estos mapas. Presente solo cuando keep_texture es true y el modelo de entrada tiene textura.

URL de descarga para una versión de thumbnail_url con fondo transparente (RGBA). Presente solo después de que la tarea se complete correctamente, cuando Meshy renderizó la vista previa transparente.

Indica si Meshy ignoró el prompt. Es 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 entonces los de Meshy, no los suyos. Presente desde PENDING en adelante. Meshy lo omite en las tareas auto y siempre que siguió el prompt.

El número de partes imprimibles que produjo la división. Los formatos que admiten objetos de escena contienen un objeto por parte. stl fusiona las partes en un único sólido, pero part_count las sigue contando. Antes de la exportación, Meshy elimina los fragmentos colapsados que no pueden convertirse en una parte imprimible y no los cuenta.

Cuánto de la tarea se ha completado, como porcentaje. Es 0 hasta que la tarea comienza y 100 cuando se completa correctamente.

El estado de la tarea, uno de PENDING, IN_PROGRESS, SUCCEEDED, FAILED o CANCELED.

El número de tareas por delante de esta en la cola. El valor solo tiene sentido mientras la tarea está en PENDING.

Hora en que se creó la tarea, en milisegundos Unix.

Hora en que comenzó la tarea, en milisegundos Unix. Es 0 hasta que la tarea comienza.

Hora en que finalizó la tarea, en milisegundos Unix. Es 0 hasta que la tarea finaliza.

Hora en que expira el resultado de la tarea, en milisegundos Unix. Es 0 hasta que la tarea finaliza.

Los detalles del error cuando la tarea falla. Consulte Errores.

Si una comprobación de seguridad rechaza el modelo de entrada, la tarea falla con task_error.type establecido en invalid_input y task_error.code establecido en provider_content_refused. Envíe un modelo diferente. Consulte Errores.

Con keep_texture: true, si Meshy no puede conservar la textura, la tarea falla con task_error.code establecido en textured_split_refused. Consulte Errores.

El número de créditos que usó la tarea. Siempre está presente. Es 10 después de que Meshy acepta la tarea, y 0 para una tarea FAILED, porque Meshy reembolsa los créditos cuando una tarea falla. Eliminar una tarea PENDING también la reembolsa.