Introducción
Meshy N1 genera el color directamente sobre el objeto 3D. Retexture recibe una malla existente y referencias visuales, sustituye la textura y devuelve un GLB con la misma forma y cantidad de caras. Usa fotos del objeto para recuperar su apariencia o una imagen de estilo para probar otra paleta. Al trabajar en 3D, reduce problemas de la proyección por vistas, como bordes dobles, colores que se mezclan y patrones cortados.
Funciones y aspectos destacados
Detalles de cuero sobre una bota blanca
Una foto frontal le dio a la bota sin textura ni UV cuero café desgastado, costuras, cordones rojos y ojales color latón. El relieve de la suela quedó café oscuro. En 35 segundos se obtuvo un GLB de 3,5 MB con una textura PNG de 2048 píxeles y los mismos 2.804 triángulos. El acabado visual no incluye mapas PBR separados.
Otra paleta sobre la misma bota
La imagen de un astronauta de juguete blanco y naranja, con la conservación de UV desactivada, produjo una bota blanca con punta gris azulada, cordones azul marino y pequeñas marcas naranjas. Aparecieron patrones similares a paneles de un traje espacial. Tardó 28 segundos: GLB de 2,6 MB y los mismos 2.804 triángulos.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
mesh_url | Sí | Malla de hasta 90 MB: GLB, FBX binario, OBJ o STL. El enlace directo debe terminar en la extensión correspondiente; convierte JSON .gltf a .glb. mínimo 1 caracteres |
reference_image_urls | No | De 1 a 4 fotos o renders de este objeto, vista frontal primero. Elige este campo o |
reference_image_url | No | Una imagen de estilo para color, apariencia del material y marcas; se interpreta como vista frontal y reemplaza |
keep_original_uv | No | Activado por defecto: conserva las UV existentes. Desactívalo para crear otro despliegue; sin UV de entrada, ambas opciones generan unas nuevas. Valor predeterminado: |
Precios
$0.48 / entrega
Cada entrega exitosa tiene un costo fijo, sin cambios por tamaño del modelo, número de referencias o keep_original_uv. Las solicitudes fallidas no se cobran, incluso por formato incorrecto o falta de referencias.
Casos de uso
Distintos acabados para un accesorio
Prueba varias paletas en un objeto de juego o un accesorio de AR manteniendo su malla. Revisa cada versión dentro de la escena: las referencias cambian el color y los detalles de superficie, sin modificar la silueta.
Darle color a un modelo blanco
Colorea un modelo blanco o el archivo digital de una pieza para impresión 3D. En una tienda en línea, puedes explorar combinaciones sobre un modelo de producto existente y revisar todos sus lados antes de mostrarlo.
Guía de prompts y consejos prácticos
Prepara la malla
Carga un GLB, FBX binario, OBJ o STL de hasta 90 MB mediante mesh_url, o usa un enlace directo terminado en .glb, .fbx, .obj o .stl. Exporta los archivos JSON .gltf como .glb. Meshy indica un máximo de 7.999.999 caras. Si aún no tienes modelo, Tripo P1, Tripo H3.1 o Seed3D 2.0 pueden crear uno a partir de una imagen.
Escoge una sola vía de referencia
Envía de 1 a 4 fotos o renders del mismo objeto en reference_image_urls, con la vista frontal primero. Como alternativa, reference_image_url acepta una imagen de estilo para colores, materiales y marcas, tratada como vista frontal. Enviar ambos campos o ninguno causa rechazo sin cobro; no se usa texto.
Elige qué hacer con las UV
Deja keep_original_uv en true para reutilizar las UV o cambia a false para desplegarlas de nuevo. Si la malla no tiene UV, se crean con cualquiera de las dos opciones. Gira el GLB entregado para revisar las uniones, la parte inferior y la ubicación de los colores.
Inicio rápido de la API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "meshy/n1/retexture",
"input": {
"mesh_url": "https://example.com/reference.png"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Consulta la referencia de la API para autenticación, el esquema completo, sondeo y gestión de errores.







