Avvio rapido

Quattro passaggi per il tuo primo modello 3D, usando l'API REST di Meshy.

1Ottieni la tua chiave API

Crea una chiave API dalle impostazioni del tuo account — non potrai più visualizzarla dopo questa schermata, quindi conservala in un luogo sicuro. Ogni richiesta viene autenticata con un token Bearer nell'intestazione Authorization — consulta Autenticazione.

2Effettua la tua prima richiesta Immagine in 3D

Esporta la tua chiave, quindi crea il tuo primo compito con Immagine in 3D. Stai lavorando da un prompt di testo o da più foto? Consulta Testo in 3D o Multi-immagine in 3D.

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

Ogni esempio sottostante utilizza questa foto — sostituisci con il tuo image_url per provare qualcosa di diverso.

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"
  }'

3Controlla lo stato del compito

Le richieste restituiscono immediatamente un ID compito. Interroga lo stesso endpoint finché status non è SUCCEEDED — sostituisci <task_id> con l'ID restituito nel passaggio 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": ""
  }
}

4Scarica il tuo modello

Ottieni il modello da model_urls nella risposta precedente. Ogni formato (GLB, FBX, OBJ, USDZ, STL) è un URL firmato e limitato nel tempo — oppure salta la linea di comando e incolla l'URL direttamente nella barra degli indirizzi del tuo browser per scaricarlo.

curl -L "<model_urls.glb dalla risposta sopra>" -o model.glb

Metti tutto insieme

Preferisci un singolo script che faccia tutto — creazione, polling, download?

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 il compito
const { data: created } = await axios.post(
  'https://api.meshy.ai/openapi/v1/image-to-3d',
  { image_url: imageUrl },
  { headers },
);
const taskId = created.result;

// 2. Polling finché non termina
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. Scarica il risultato
const { data: model } = await axios.get(task.model_urls.glb, { responseType: 'arraybuffer' });
fs.writeFileSync('model.glb', model);
console.log('Saved model.glb');

Esplora flussi di lavoro comuni

Passi successivi

• Preferisci un'interfaccia utente? Prova l'API Playground — configura una richiesta, eseguila e copia il codice generato.
• Sfoglia l'intera referenza API per ogni endpoint.
• Controlla Prezzi, Limiti di tasso, e Errori prima di andare in produzione.
• Guarda il changelog per aggiornamenti e correzioni di bug.
• Hai feedback o stai affrontando problemi? Unisciti alla nostra community di Discord — ci piacerebbe avere tue notizie!