Snelstart

Vier stappen naar je eerste 3D-model, met behulp van de Meshy REST API.

1Verkrijg je API-sleutel

Maak een API-sleutel aan vanuit je accountinstellingen — je zult het na dit scherm niet meer kunnen zien, dus sla het ergens veilig op. Elke aanvraag verifieert met een Bearer token in de Authorization header — zie Authenticatie.

2Dien je eerste Afbeelding-naar-3D-verzoek in

Exporteer je sleutel en maak dan je eerste taak aan met Afbeelding naar 3D. Werk je liever vanuit een tekstprompt of meerdere foto's? Bekijk Tekst naar 3D of Multi-afbeelding naar 3D.

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

Elk voorbeeld hieronder gebruikt deze foto — wissel je eigen image_url in om iets anders te proberen.

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

3Controleer de taakstatus

Aanvragen geven meteen een taak-ID terug. Poll dezelfde endpoint totdat status SUCCEEDED is — vervang <task_id> hieronder met de ID die in stap 2 is geretourneerd.

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

4Download je model

Pak het model uit model_urls in de bovenstaande reactie. Elk formaat (GLB, FBX, OBJ, USDZ, STL) is een getekende, tijdsgebonden URL — of sla de opdrachtregel over en plak de URL rechtstreeks in de adresbalk van je browser om het te downloaden.

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

Zet alles in elkaar

Geef je de voorkeur aan één script dat alles doet — maken, poll, downloaden?

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

// 2. Poll tot het klaar is
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. Download het resultaat
const { data: model } = await axios.get(task.model_urls.glb, { responseType: 'arraybuffer' });
fs.writeFileSync('model.glb', model);
console.log('Opgeslagen model.glb');

Verken veelvoorkomende workflows

Volgende stappen

• Geef je de voorkeur aan een UI? Probeer de API Playground — configureer een aanvraag, voer deze uit, en kopieer de gegenereerde code.
• Blader door de volledige API-referentie voor elke endpoint.
• Controleer Prijzen, Rate Limits, en Fouten voordat je naar productie gaat.
• Bekijk de Changelog voor updates en foutoplossingen.
• Heb je feedback of problemen? Doe mee met onze Discord community — we horen graag van je!