Inicio rápido

Cuatro pasos para tu primer modelo 3D, usando la API REST de Meshy.

1Obtén tu clave de API

Crea una clave de API desde la configuración de tu cuenta — no podrás verla de nuevo después de esta pantalla, así que guárdala en un lugar seguro. Cada solicitud se autentica con un token Bearer en el encabezado Authorization — ver Autenticación.

2Haz tu primera solicitud de Imagen a 3D

Exporta tu clave, luego crea tu primera tarea con Imagen a 3D. ¿Trabajando desde un prompt de texto o múltiples fotos? Consulta Texto a 3D o Multi-imagen a 3D.

export MESHY_API_KEY="<your-api-key>"

Cada ejemplo a continuación usa esta foto — reemplaza con tu propio image_url para probar otra cosa.

Copy image URL

curl https://api.meshy.ai/openapi/v1/image-to-3d \
  -X POST \
  -H "Authorization: Bearer ${MESHY_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://docs.meshy.ai/images/api/quick-start/source-photo.webp"
  }'

3Verifica el estado de la tarea

Las solicitudes devuelven una ID de tarea de inmediato. Haz polling al mismo endpoint hasta que el status sea SUCCEEDED — reemplaza <task_id> a continuación con la ID devuelta en el paso 2.

curl https://api.meshy.ai/openapi/v1/image-to-3d/<task_id> \
  -H "Authorization: Bearer ${MESHY_API_KEY}"

{
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "status": "SUCCEEDED",
  "progress": 100,
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.glb?Expires=***",
    "fbx": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.fbx?Expires=***"
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview.png?Expires=***",
  "task_error": {
    "message": ""
  }
}

4Descarga tu modelo

Obtén el modelo desde model_urls en la respuesta anterior. Cada formato (GLB, FBX, OBJ, USDZ, STL) es una URL firmada con tiempo limitado — o salta la línea de comandos y pega la URL directamente en la barra de direcciones de tu navegador para descargarlo.

curl -L "<model_urls.glb from the response above>" -o model.glb

Mézclalo todo

¿Prefieres un script que haga todo — crear, hacer polling, descargar?

import axios from 'axios';
import fs from 'fs';

const headers = { Authorization: `Bearer ${process.env.MESHY_API_KEY}` };
const imageUrl = 'https://docs.meshy.ai/images/api/quick-start/source-photo.webp';

// 1. Crea la tarea
const { data: created } = await axios.post(
  'https://api.meshy.ai/openapi/v1/image-to-3d',
  { image_url: imageUrl },
  { headers },
);
const taskId = created.result;

// 2. Haz polling hasta que termine
let task;
while (true) {
  const { data } = await axios.get(`https://api.meshy.ai/openapi/v1/image-to-3d/${taskId}`, { headers });
  task = data;
  if (task.status === 'SUCCEEDED' || task.status === 'FAILED') break;
  await new Promise((resolve) => setTimeout(resolve, 5000));
}

// 3. Descarga el resultado
const { data: model } = await axios.get(task.model_urls.glb, { responseType: 'arraybuffer' });
fs.writeFileSync('model.glb', model);
console.log('Saved model.glb');

Explora flujos de trabajo comunes

Próximos pasos

• ¿Prefieres una interfaz de usuario? Prueba el API Playground — configura una solicitud, ejecútala y copia el código generado.
• Consulta la Referencia completa de API para cada endpoint.
• Revisa Precios, Límites de tasa y Errores antes de ir a producción.
• Observa el Registro de cambios para actualizaciones y correcciones de errores.
• ¿Tienes comentarios o enfrentas problemas? Únete a nuestra comunidad en Discord — ¡nos encantaría escucharte!