Schnellstart

Vier Schritte zu Ihrem ersten 3D-Modell mit der Meshy REST API.

1Holen Sie sich Ihren API-Schlüssel

Erstellen Sie einen API-Schlüssel in Ihren Kontoeinstellungen — Sie können ihn nach diesem Bildschirm nicht wieder anzeigen, also speichern Sie ihn an einem sicheren Ort. Jede Anfrage authentifiziert sich mit einem Bearer-Token im Authorization-Header — siehe Authentifizierung.

2Machen Sie Ihre erste Bild-zu-3D-Anfrage

Exportieren Sie Ihren Schlüssel und erstellen Sie dann Ihre erste Aufgabe mit Bild zu 3D. Arbeiten Sie stattdessen von einer Texteingabeaufforderung oder mehreren Fotos aus? Sehen Sie sich Text zu 3D oder Multi-Bild zu 3D an.

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

Jedes Beispiel unten verwendet dieses Foto — tauschen Sie Ihre eigene image_url ein, um etwas anderes auszuprobieren.

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

3Überprüfen Sie den Auftragsstatus

Anfragen geben sofort eine Aufgaben-ID zurück. Pollen Sie denselben Endpoint, bis status SUCCEEDED ist — ersetzen Sie <task_id> unten durch die in Schritt 2 zurückgegebene ID.

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

4Laden Sie Ihr Modell herunter

Holen Sie sich das Modell von model_urls in der obigen Antwort. Jedes Format (GLB, FBX, OBJ, USDZ, STL) ist eine signierte, zeitlich begrenzte URL — oder umgehen Sie die Befehlszeile und fügen Sie die URL direkt in die Adressleiste Ihres Browsers ein, um sie herunterzuladen.

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

Alles zusammenfügen

Bevorzugen Sie ein Skript, das alles erledigt — erstellen, pollen, herunterladen?

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

// 2. Pollen bis die Fertigstellung
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. Ergebnis herunterladen
const { data: model } = await axios.get(task.model_urls.glb, { responseType: 'arraybuffer' });
fs.writeFileSync('model.glb', model);
console.log('Gespeichert model.glb');

Entdecken Sie häufige Arbeitsabläufe

Nächste Schritte

• Bevorzugen Sie eine UI? Versuchen Sie den API-Playground — konfigurieren Sie eine Anfrage, führen Sie sie aus, und kopieren Sie den generierten Code.
• Blättern Sie durch die vollständige API-Referenz für jeden Endpoint.
• Überprüfen Sie Preise, Rate Limits und Fehler, bevor Sie in Produktion gehen.
• Achten Sie auf das Changelog für Updates und Fehlerbehebungen.
• Haben Sie Feedback oder stehen Sie vor Problemen? Treten Sie unserer Discord Community bei — wir freuen uns, von Ihnen zu hören!