API de Remallado

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

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

El modelo debe ser un archivo GLB, glTF, OBJ, FBX o STL de como máximo 400 MB desde una URL http o https, o de 100 MB como data URI. Para un data URI, usa el MIME type application/octet-stream.

Un archivo de más de 100 MB también debe cumplir 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, así 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 posterior.
• Un archivo GLB o glTF no debe usar compresión Draco.

Los formatos de archivo a generar.

Valores disponibles:

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

El tipo de cara del modelo remallado.

Valores disponibles:

• quad: una malla predominantemente de cuadriláteros
• triangle: una malla de triángulos diezmada

El número de caras a alcanzar, de 100 a 300000. El resultado puede diferir del objetivo, según la geometría del modelo. Un valor fuera del rango devuelve 400.

Número de caras adaptativo, por nivel. Cuando lo configuras, Meshy ignora target_polycount.

Valores disponibles:

• 1: ultra
• 2: alto
• 3: medio
• 4: bajo

Usa la API de Redimensionar en su lugar. La altura a la que redimensionar el modelo, en metros. Envía como máximo uno de resize_height, resize_longest_side y auto_size.

Usa la API de Redimensionar en su lugar. La longitud a la que redimensionar el lado más largo de la caja delimitadora del modelo, en metros. Envía como máximo uno de resize_height, resize_longest_side y auto_size.

Usa la API de Redimensionar en su lugar. Si se debe estimar la altura real del objeto con visión de IA y redimensionar el modelo a ella. Envía como máximo uno de resize_height, resize_longest_side y auto_size.

Usa la API de Redimensionar en su lugar. Dónde colocar el origen del modelo, bottom o center. El valor predeterminado se aplica cuando envías resize_height, resize_longest_side o auto_size. Sin ninguno de ellos, Meshy mueve el origen solo si envías origin_at.

Usa la API de Convertir en su lugar. Si se debe solo convertir el modelo a target_formats. Cuando es true, Meshy ignora topology, target_polycount, decimation_mode, resize_height, resize_longest_side y auto_size, pero aún verifica sus valores, por lo que un valor inválido devuelve 400. Con convert_format_only: true, un target_formats vacío o null devuelve 400.

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

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

• Falta un parámetro: No se envió ni model_url ni input_task_id.
• Tarea de entrada inválida: input_task_id no es una tarea de API exitosa, o su modelo de IA no admite remallado.
• Formato de modelo inválido: El archivo de model_url tiene una extensión no compatible.
• URL inaccesible: Meshy no puede descargar el archivo de model_url.
• Archivo de modelo demasiado grande: El archivo de model_url supera los 400 MB desde una URL http o https, o los 100 MB como data URI.
• Demasiadas caras: El archivo de model_url supera los 100 MB y tiene 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 verificar. Reduce el número de objetos en el archivo y vuelve a enviarlo.
• Topología inválida: topology no es quad ni triangle.
• Parámetros mutuamente excluyentes: La solicitud tiene más de uno de auto_size, resize_height y resize_longest_side. Envía solo uno.

Corrige la solicitud y vuelve a enviarla. 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. Mejora tu plan en la configuración de tu suscripción y vuelve a intentarlo.

input_task_id es un modelo de bajorrelieve, que este endpoint no puede remallar. 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 proveniente de la respuesta de creación.

El ID de la tarea a eliminar.

El número de página a devolver.

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

El orden de clasificación.

Valores disponibles:

• +created_at: el más antiguo primero
• -created_at: el más reciente 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 dependa de su formato.

El tipo de tarea, siempre remesh.

URLs de descarga para el modelo remallado, una por cada formato de archivo. 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 remallado.

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

Cuánto de la tarea está completado, 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 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.

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.