API de Relieve

La foto para convertir en relieve, como una URL pública o un Data URI (data:image/png;base64,...).

La imagen debe ser un archivo JPG, JPEG, PNG o WebP de máximo 20 MB, y al menos 32 × 32 píxeles. Su lado más largo puede ser como máximo unas 16 veces su lado más corto. Cualquier otra imagen devuelve 400. Meshy rellena las áreas transparentes con negro antes de construir el relieve.

El estilo del relieve. Define la forma del mapa de profundidad y establece el valor predeterminado de carving_depth_mm.

Valores disponibles:

• high: tallado más profundo, para piezas impresas en 3D.
• low: tallado superficial, para grabado láser, tallado CNC y placas delgadas.

Enviar null o "" es lo mismo que omitirlo. Cualquier otro valor devuelve 400.

Indica si se debe construir el modelo de relieve. Establécelo en false para una tarea que genere solo el mapa de profundidad, sin modelo ni imagen de vista previa. Meshy sigue comprobando los parámetros de tamaño, tallado, base, curvatura y resolución, pero no los utiliza. No cambia el costo en créditos.

La longitud del lado más largo de la foto en el modelo, medida en plano antes de cualquier curvatura, de 20 a 250 milímetros. Con remove_base, el modelo puede ser más pequeño.

Indica si el sujeto resalta de la placa o se corta en ella.

Valores disponibles:

• emboss: las partes más cercanas de la foto resaltan.
• engrave: la profundidad se invierte, de modo que las partes más cercanas quedan cortadas hacia adentro.

El mapa de profundidad es el mismo en ambos modos.

Qué tan profundo se talla el relieve, de 0 a 60 milímetros. Con remove_base establecido en true, 0 deja un modelo vacío. La tarea sigue teniendo éxito y cuesta 20 créditos, y sus archivos GLB y STL no tienen geometría.

Indica si se debe recortar el fondo y no construir una placa base. Cuando es true, removal_threshold establece qué se considera fondo. Meshy comprueba removal_threshold en ambos casos.

El grosor de la placa base, de 0.1 a 10 milímetros. Cuando remove_base es true, omítelo o envía 0.

Indica si se debe curvar el relieve, y en qué dirección. Cuando no es off, bend_axis y bend_angle definen la curvatura. Meshy los comprueba en ambos casos.

Valores disponibles:

• off: un relieve plano.
• convex: el frente se abomba hacia afuera.
• concave: el frente se curva hacia adentro.

El número de puntos de malla a lo largo del lado más largo de la foto, de 512 a 2048. Un valor más alto conserva detalles más finos y genera archivos más grandes. Con el valor predeterminado de 1024, el archivo GLB tiene aproximadamente de 40 a 50 MB y el archivo STL aproximadamente de 80 a 105 MB. Una foto cuadrada da los tamaños mayores. A 2048, tienen aproximadamente 150 MB y 300 MB. Una curvatura los hace más grandes: el archivo STL puede alcanzar aproximadamente 800 MB a 2048.

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

• Parámetro faltante: no se envió image_url.
• Parámetro inválido: un parámetro tiene el tipo incorrecto, está fuera de su rango o no es uno de sus valores disponibles. Por ejemplo, variant no es high ni low, o mesh_resolution no es un entero de 512 a 2048.
• Grosor de base: base_thickness_mm no es 0 con remove_base establecido en true, o es menor que 0.1 sin él.
• URL inaccesible: Meshy no puede descargar la imagen de image_url, por ejemplo porque la URL devuelve 404 o agota el tiempo de espera.
• Imagen inválida: la imagen no es un archivo JPG, JPEG, PNG o WebP, supera los 20 MB, es más pequeña que 32 × 32 píxeles, tiene demasiados píxeles o no se puede leer.
• Relación de aspecto extrema: el lado más largo de la imagen es más de unas 16 veces su lado más corto.

Corrige la solicitud y envíala de nuevo. Meshy no cobra por ello. Consulta Errores.

Falta la clave de API o es invá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. Actualiza tu plan en la configuración de tu suscripción, luego vuelve a intentarlo.

La moderation de contenido bloqueó la imagen. Meshy no cobra por la solicitud. Envía una imagen diferente.

Se alcanzó uno de estos límites:

• Enviaste demasiadas solicitudes. Espera y vuelve a intentarlo. Consulta Límites de velocidad.
• Hay demasiadas tareas tuyas en cola o en ejecución. Espera a que algunas terminen y vuelve a intentarlo.
• En un plan ilimitado sin créditos disponibles, alcanzaste el número de tareas que pueden ejecutarse sin créditos. Espera a que termine una tarea, o agrega créditos.

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. 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 de 101 a 255 como 100, y un valor mayor devuelve 400.

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 proporcionado en la respuesta de creación.

El ID de la tarea. Trátelo como una cadena opaca y no confíe en su formato.

El tipo de tarea, siempre relief.

URLs de descarga para el modelo de relieve. Los archivos pueden ser grandes; mesh_resolution enumera los tamaños típicos.

URL de descarga para el mapa de profundidad en escala de grises de 16 bits a partir del cual se construye el relieve. Los píxeles más brillantes son más altos. Los valores son alturas relativas, no milímetros. El software de grabado láser y CNC puede usarlo como un mapa de altura. El archivo pesa entre 1 y 2 MB aproximadamente. Vacío si no hay ninguno.

URL de descarga para una imagen de vista previa del modelo de relieve. Vacío si no se renderizó ninguna, incluso para una tarea de solo mapa de profundidad.

Cuánto se ha completado de la tarea, como un 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 campo se omite cuando el valor es 0, por lo que aparece solo mientras hay tareas por delante de esta.

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.

El número de créditos que usó la tarea: 20, o 0 para una tarea FAILED, que Meshy reembolsa.