API de Retexturizar

Obligatorio a menos que envíes model_url. El ID de una tarea que produjo un modelo 3D para texturizar, por ejemplo una tarea de Texto a 3D, Imagen a 3D, Remallado o Retexturizar. La tarea debe ser una que hayas creado con la API y tenga el estado SUCCEEDED. Meshy texturiza el GLB de la tarea.

Obligatorio a menos que envíes input_task_id. El modelo a texturizar, 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, por ejemplo data:application/octet-stream;base64,<tus datos del modelo codificados en base64>.

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 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.

Obligatorio a menos que envíes image_style_url o multiview_image_urls. Texto que describe la textura que deseas, hasta 800 caracteres. Un texto más largo devuelve 400.

Obligatorio a menos que envíes text_style_prompt o multiview_image_urls. Una imagen 2D cuyo estilo sigue la textura, como una URL pública o un Data URI (data:image/jpeg;base64,<tus datos de imagen codificados en base64>). Si envías tanto text_style_prompt como image_style_url, Meshy usa image_style_url.

La imagen debe ser un archivo .jpg, .jpeg, .png o .webp de como máximo 20 MB.

Es posible que la textura no encaje bien cuando el objeto de la imagen tiene una forma muy diferente a la del modelo.

Obligatorio a menos que envíes text_style_prompt o image_style_url. De una a cuatro imágenes del mismo objeto desde distintas vistas. La primera imagen es la vista principal (frontal). El orden de las demás vistas (izquierda, trasera, derecha) no importa. Un array vacío, o más de cuatro imágenes, devuelve 400.

Cada imagen sigue las mismas reglas de formato y tamaño que image_style_url, como máximo 20 MB por imagen. No puedes combinar multiview_image_urls con text_style_prompt o image_style_url.

multiview_image_urls necesita un "ai_model": "meshy-7" explícito. Cualquier otro ai_model, incluido el latest predeterminado, devuelve 400.

El modelo de IA que genera la textura.

Valores disponibles:

• meshy-6-lite
• meshy-6
• meshy-7
• latest: Meshy 7

Si se debe mantener la distribución UV del modelo en lugar de generar una nueva.

• Para un modelo que Meshy generó, a partir de input_task_id o de un model_url que apunte a una salida de Meshy, usa true para reutilizar su distribución UV optimizada.
• Para un modelo que subiste desde otro lugar, usa true para conservar UVs que ya sean buenas. Déjalo en false para que Meshy genere nuevas UVs, lo cual conviene a un modelo sin un mapeo UV adecuado.

Si también se deben generar mapas PBR (metálico, rugosidad y normal) junto con el color base. Con meshy-6, Meshy también genera un mapa de emisión, excepto con una texture_resolution de 8k. meshy-6-lite, meshy-7 y latest no generan un mapa de emisión.

El tamaño de la textura de color base. Las resoluciones más altas capturan más detalle de superficie.

Valores disponibles:

• 2k: 2048 × 2048 píxeles
• 4k: 4096 × 4096 píxeles
• 8k: 8192 × 8192 píxeles

4k y 8k necesitan un ai_model de meshy-6, meshy-7 o latest. Con meshy-6-lite, devuelven 400. En 8k, Meshy no genera un mapa de emisión.

Usa texture_resolution en su lugar. true equivale a texture_resolution: "4k". Si envías ambos, Meshy usa texture_resolution.

Si se deben eliminar los brillos y las sombras de la textura de color base. El resultado funciona mejor con tu propia iluminación.

Meshy lo aplica solo con meshy-6, con una texture_resolution de 2k o 4k. Con meshy-7 o latest, o en 8k, Meshy lo acepta y lo ignora. Con meshy-6-lite, enviarlo con cualquier valor devuelve 400.

Los formatos de archivo a generar. Meshy genera solo los formatos que enumeres, lo que puede acortar la tarea. Si lo omites, Meshy genera todos los formatos excepto 3mf.

Valores disponibles:

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

Si también se debe renderizar 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.
• Falta el estilo: No se envió ninguno de text_style_prompt, image_style_url ni multiview_image_urls.
• Entradas de estilo en conflicto: multiview_image_urls se envió junto con text_style_prompt o image_style_url.
• Modelo no compatible con multivista: multiview_image_urls se envió sin un "ai_model": "meshy-7" explícito.
• Tarea de entrada no válida: input_task_id no es una tarea exitosa de un tipo compatible.
• Formato de modelo no válido: El archivo de model_url tiene una extensión no compatible.
• URL inaccesible: Meshy no puede descargar el archivo de model_url, la imagen de image_style_url o una imagen de multiview_image_urls.
• 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 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 la versión 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.
• Imagen demasiado grande: La imagen de image_style_url o una imagen de multiview_image_urls supera los 20 MB.

Corrige la solicitud y vuelve a enviarla. 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 créditos suficientes para esta tarea, o la cuenta alcanzó un límite de créditos. Verifica 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 retexturizar. 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. Verifica 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 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: más antiguas primero
• -created_at: más recientes primero

El ID de la tarea 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 retexture.

URLs de descarga para el modelo 3D texturizado, una por cada formato de archivo.

El prompt de texto con el que creó la tarea.

La imagen de estilo con la que creó la tarea.

URLs de descarga para las imágenes de referencia de Multivista con las que creó la tarea. Presente solo cuando creó la tarea con multiview_image_urls.

URL de descarga para una imagen en miniatura del modelo.

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 porcentaje. Es 0 hasta que la tarea comienza y 100 cuando tiene éxito.

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

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

Hora en que expiran los resultados de la tarea, en milisegundos Unix.

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

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

URLs de descarga para las texturas generadas, como un array de objetos. El array normalmente contiene un objeto. Cada objeto tiene estos campos:

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

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.