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

Una tarea de Analizar imprimibilidad que haya comprobado el grosor de pared también transmite su impresora y tamaño. La reparación entonces comprueba el grosor de pared y engrosa las paredes delgadas, incluso si no envías ninguno de los dos. Un printer_type o un tamaño de impresión que envíes reemplaza al de el análisis. Una tarea de Analizar imprimibilidad de un archivo .stl, .fbx o .gltf desde model_url no funciona. Envía ese archivo como model_url en su lugar.

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

Desde una URL http o https, el modelo debe ser un archivo .glb, .gltf, .obj, .fbx o .stl de como máximo 400 MB. Un Data URI solo puede contener un archivo GLB en base64 (data:model/gltf-binary;base64,...) o glTF (data:model/gltf+json;base64,...) de como máximo 100 MB. Envía un archivo .obj, .fbx o .stl como una URL http o https.

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

• Un archivo GLB, glTF, FBX u OBJ puede tener como máximo 10,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 o glTF no debe usar compresión Draco.

Una URL de descarga de Meshy (assets.meshy.ai/…?Expires=…&Signature=…) está firmada y deja de funcionar en su expires_at. Volver a leer la tarea no la renueva. Para un modelo que hayas creado con Meshy, envía input_task_id en su lugar, que funciona mientras Meshy conserve la tarea de origen (consulta Retención de recursos). Para usar el modelo después de eso, descárgalo antes de expires_at y envía tu propia copia.

Indica si se debe renderizar también una vista previa con fondo transparente (RGBA), devuelta en alpha_thumbnail_url cuando obtengas la tarea. thumbnail_url no cambia.

La impresora que planeas usar. Establece el grosor de pared mínimo al que apunta la reparación. Si envías un tamaño de impresión sin printer_type, Meshy usa fdm, a menos que una tarea de Analizar imprimibilidad en input_task_id proporcione la impresora.

Valores disponibles:

• fdm: filamento, pared mínima de 1.0 mm
• sla: resina, pared mínima de 0.8 mm
• full_color: color completo, pared mínima de 2.0 mm

Cualquier otro valor devuelve 400.

La altura de la impresión, en milímetros, de 1 a 1000. Un valor fuera de ese rango devuelve 400. Envía esto o intended_print_longest_side_mm, no ambos.

Solo funciona con entrada GLB. Para un model_url que no sea un archivo .glb, envía intended_print_longest_side_mm en su lugar.

La longitud del lado más largo de la impresión, en milímetros, de 1 a 1000. Un valor fuera de ese rango devuelve 400. Funciona con todos los formatos de entrada.

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

• Falta un parámetro: No se envió ni input_task_id ni model_url.
• UUID inválido: input_task_id no es un UUID válido.
• URL de modelo inválida: model_url tiene un formato incorrecto, usa un esquema no compatible o tiene una extensión de archivo no compatible.
• Archivo de modelo demasiado grande: El archivo de model_url supera los 400 MB desde una URL http o https, o supera los 100 MB como Data URI.
• Demasiadas caras: El archivo de model_url es un archivo GLB, glTF, FBX u OBJ de más de 100 MB con más de 10,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 de 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 de model_url supera los 100 MB, y Meshy no puede leer su encabezado. Por ejemplo, es un GLB o glTF comprimido con Draco, o un FBX binario anterior a 7.1.
• Encabezado del modelo demasiado complejo: El archivo de model_url supera los 100 MB, y su encabezado tiene demasiadas mallas, nodos o registros para comprobar. Reduce el número de objetos del archivo y vuelve a enviarlo.
• No se puede descargar el archivo de modelo: model_url devolvió un error, casi siempre porque una URL de descarga firmada de Meshy caducó. Volver a leer la tarea devuelve la misma URL con la misma caducidad. Envía tu propia copia del archivo, o envía input_task_id mientras Meshy conserve la tarea de origen.
• Tarea no completada: La tarea de input_task_id sigue pendiente, en progreso o ha fallado.
• Falta GLB: La tarea de input_task_id no tiene un modelo GLB para reparar.
• Tamaño de impresión inválido: intended_print_height_mm o intended_print_longest_side_mm está fuera de 1 a 1000, o la solicitud tiene ambos.
• Tipo de impresora desconocido: printer_type no es fdm, sla ni full_color.
• Altura en un modelo que no es GLB: La solicitud tiene intended_print_height_mm y un model_url que no es un archivo .glb. Envía intended_print_longest_side_mm en su lugar.
• No se puede dimensionar este modelo por altura: Con la altura solicitada, o con los 150 mm predeterminados, el lado más largo del modelo quedaría fuera de 1 a 1,000 mm. También ocurre cuando el modelo es plano, o cuando Meshy no puede determinar su tamaño. Envía intended_print_longest_side_mm en su lugar. Para un model_url .glb y algunas tareas de input_task_id, Meshy descubre esto solo después de que la tarea comienza, y la tarea termina como FAILED en su lugar.
• Tamaño de STL inutilizable: La solicitud tiene printer_type sin un tamaño, y Meshy no puede leer el lado más largo propio del archivo .stl, o está fuera de 1 a 1,000 mm. Envía intended_print_longest_side_mm.

Corrige la solicitud y vuelve a enviarla. Consulta Errores.

Falta la clave de API o no es válida. Comprueba 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. Comprueba 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 reparar. El mensaje es This model type does not support this operation. Envía un modelo diferente.

La tarea de input_task_id no existe o pertenece a otro usuario. Comprueba el ID y usa una clave de API de la cuenta que creó la tarea.

Superaste tu límite de tasa, o tienes demasiadas tareas pendientes. Espera y vuelve a intentarlo. Consulta Límites de tasa.

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

El ID de la tarea a eliminar.

El número de página a devolver, comenzando en 1.

El número de tareas por página, hasta 100.

El orden de clasificación.

Valores disponibles:

• +created_at: las más antiguas primero
• -created_at: las 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-repair.

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

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

El número de tareas por delante de esta en la cola. El valor solo es significativo 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. Es null si la tarea no ha fallado. Consulte Errores.

URLs de descarga para el modelo reparado. Solo tiene la clave que coincide con el formato de entrada. Un formato que la tarea no generó no tiene clave, en lugar de una cadena vacía.

URL de descarga para una imagen de vista previa del modelo reparado.

URL de descarga para una versión de thumbnail_url con fondo transparente (RGBA). Presente solo cuando usted creó la tarea con alpha_thumbnail: true y Meshy renderizó la vista previa transparente.

Siempre un array vacío. La reparación conserva solo la geometría de entrada y no vuelve a generar las texturas.

El número de créditos que usó la tarea. Es 10 cuando la tarea está SUCCEEDED, y 0 para una tarea FAILED, porque Meshy reembolsa los créditos cuando una tarea falla.

La impresora y el tamaño que usó la reparación, ya sea que usted los enviara o Meshy los reutilizara de una tarea Analizar imprimibilidad. Presente desde el inicio en una reparación de grosor de pared, incluso mientras la tarea está en PENDING. Un valor que Meshy aún no conoce es null.

Qué hizo la reparación de grosor de pared. Presente después de que una reparación de grosor de pared tiene éxito.