API de Impresión Multicolor

Obligatorio a menos que envíes model_url. El ID de la tarea cuyo modelo quieres imprimir, por ejemplo una tarea de Imagen a 3D, Multi-imagen a 3D, Texto a 3D, Remallado o Retexturizar. La tarea debe ser una que hayas creado con la API y tener el estado SUCCEEDED.

Multi-Color Print lee el archivo GLB de la tarea, que 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 la tarea de remallado en su lugar.

Obligatorio a menos que envíes input_task_id. El modelo a imprimir, como una URL pública o un data URI. Si envías ambos, Meshy usa input_task_id.

Una URL http o https debe apuntar a un archivo .glb o .fbx de un máximo de 400 MB. Un data URI debe contener un archivo GLB en base64 de un máximo de 100 MB. Usa data:model/gltf-binary;base64,. Envía un archivo .fbx como una URL http o https.

Un archivo de más de 100 MB también debe cumplir estas reglas:

• Puede tener como máximo 8,000,000 de caras. Meshy cuenta las caras como triángulos, por lo que un cuadrilátero cuenta como 2, y una malla dibujada más de una vez cuenta una vez por copia.
• Un archivo FBX debe ser FBX binario 7.1 o más reciente.
• Un archivo GLB no debe usar compresión Draco.

El número máximo de colores en la paleta de salida, de 1 a 16. Para usar el valor predeterminado, omítelo en lugar de enviar 0.

El estilo de color del archivo 3MF.

Valores disponibles:

• realistic: toma muestras de colores directamente de la textura del modelo para obtener un detalle fino y fotorrealista, y genera un archivo más grande.
• cartoon: aplana los colores en regiones uniformes y limpias para un aspecto estilizado, y genera un archivo más pequeño.

El modelo debe tener color. realistic necesita una única textura de color base, con UVs en cada parte de la malla, y cartoon también acepta colores de vértice. Meshy rechaza un modelo sin textura (blanco). Consulta model_missing_texture.

La profundidad de subdivisión que Meshy usa para muestrear los colores de la textura sobre la malla, de 3 a 6. 0 equivale a omitirlo. Valores más altos capturan un detalle de color más fino y generan un archivo más grande. Solo el estilo realistic lo usa, y cartoon lo ignora.

La marca de impresora cuyo preset de laminador Meshy escribe en el archivo 3MF. El archivo se abre entonces en el laminador de esa marca con un perfil de impresora, filamento y proceso correspondiente. El preset usa la impresora predeterminada de la marca, con una boquilla de 0.4 mm.

Valores disponibles:

• bambu
• anycubic
• creality
• elegoo
• flashforge
• prusa
• qidi
• snapmaker
• ankermake

Cualquier otro valor devuelve 400.

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

• Parámetro faltante: No se envió ni model_url ni input_task_id.
• Formato de modelo inválido: El archivo model_url no es un archivo .glb ni .fbx.
• URL inaccesible: Meshy no puede descargar el archivo model_url.
• Archivo de modelo demasiado grande: El archivo model_url supera los 400 MB desde una URL http o https, o supera los 100 MB como data URI.
• Demasiadas caras: El archivo model_url supera los 100 MB y tiene más de 8,000,000 de caras. Reduce el número de caras y vuelve a enviar el archivo.
• FBX ASCII de más de 100 MB: El archivo model_url es un FBX ASCII de más de 100 MB. Envíalo como FBX binario o GLB.
• Archivo de modelo ilegible: El archivo model_url supera los 100 MB, y Meshy no puede leer su encabezado. Por ejemplo, es un GLB comprimido con Draco, o un FBX binario anterior a la versión 7.1.
• Encabezado del modelo demasiado complejo: El archivo model_url supera los 100 MB, y su encabezado tiene demasiadas mallas, nodos o registros para verificar. Reduce el número de objetos en el archivo y vuelve a enviarlo.
• Tarea de entrada inválida: input_task_id no corresponde a una tarea exitosa.
• Demasiadas caras en la tarea de entrada: El modelo de input_task_id tiene más de 8,000,000 de caras. Ejecuta una tarea de remallado sobre él y envía el ID de esa tarea en su lugar.
• max_colors inválido: max_colors es negativo o supera 16.
• style inválido: style no es realistic ni cartoon.
• max_depth inválido: max_depth está fuera del rango de 3 a 6, y no es 0.
• printer_brand inválido: printer_brand no corresponde a uno de sus valores disponibles.
• Sin fuente de color: El modelo carece del color que necesita style. realistic necesita una única textura de color base, con UVs, en cada parte de la malla. cartoon acepta una textura de color base o colores de vértice. Aplica textura al modelo primero, o usa cartoon para un modelo con colores de vértice. Meshy verifica una carga .fbx solo después de que la tarea la normaliza, por lo que la tarea falla con model_missing_texture en su lugar.

Corrige la solicitud y vuelve a enviarla. Consulta Errores.

La clave de API falta o no es válida. Revisa 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. Mejora tu plan en la configuración de suscripción, y vuelve a intentarlo.

input_task_id es un modelo de bajorrelieve, que este endpoint no puede imprimir. El mensaje es This model type does not support this operation. Envía un modelo diferente.

input_task_id no coincide con ninguna de tus tareas. Revisa el ID de la tarea y vuelve a enviar la solicitud.

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

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

El ID de la tarea que se va a eliminar.

El número de página a devolver. Los números de página comienzan en 1.

El número de tareas por página, hasta 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-multi-color.

URLs de descarga para el modelo impreso, una por cada formato de archivo. Un formato que la tarea no generó no tiene clave, en lugar de tener una cadena vacía.

Cuánto de la tarea está completado, como porcentaje. Es 0 hasta que la tarea comienza y 100 cuando tiene éxito.

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

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

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

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

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

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

El número de créditos que usó la tarea. Presente cuando el estado es PENDING, IN_PROGRESS o SUCCEEDED. Es 0 para una tarea FAILED, porque Meshy reembolsa los créditos cuando una tarea falla.