Snabbstart

Börja med att skapa din API-nyckel

Varje förfrågan i denna guide behöver en. Att skapa en nyckel tar mindre än en minut.

Skapa din API-nyckel

Fyra steg till din första 3D-modell, med hjälp av Meshy REST API.

Använder du en AI-kodassistans? Se vår AI-integration sida – installera Meshy MCP server för verktygsanrop från Claude Code, Cursor, Windsurf och andra MCP-kompatibla verktyg, eller rikta en vanlig chatbot mot llms.txt.

1Hämta din API-nyckel

Skapa en API-nyckel från dina kontoinställningar – du kommer inte att kunna visa den igen efter denna skärm, så lagra den någonstans säkert. Varje förfrågan autentiseras med en Bearer-token i Authorization-headern – se autentisering.

Öppna API-inställningar från API-menyn och skapa sedan din nyckel

Säkerhetstips: undvik att klistra in din nyckel direkt i skript – lagra den istället som en miljövariabel: export MESHY_API_KEY="msy_...".

2Gör din första Bild till 3D-förfrågan

Exportera din nyckel, skapa sedan din första uppgift med Bild till 3D. Arbetar du från en textprompt eller flera foton istället? Se Text till 3D eller Flera bilder till 3D.

Exportera din nyckel

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

Kör detta i din terminal (Terminal på macOS, Kommandotolken eller PowerShell på Windows) – inte i en webbläsare.

Alla exempel nedan använder detta foto – byt ut ditt eget image_url för att testa något annat.

Exempel bild av katt som används som Bild till 3D-ingång i denna guide
Exempel ingång

Förfrågan

POST
/openapi/v1/image-to-3d
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"
  }'

3Kontrollera arbetsstatus

Förfrågningar returnerar ett uppgifts-ID omedelbart. Poll samma endpoint tills status är SUCCEEDED – ersätt <task_id> nedan med det ID som returnerades i steg 2.

Förfrågan

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

Svar — SUCCEEDED

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

Gillar du inte polling? Använd SSE-strömning eller en Webhook för att bli notifierad så fort en uppgift är klar.

4Ladda ner din modell

Ta modellen från model_urls i svaret ovan. Varje format (GLB, FBX, OBJ, USDZ, STL) är en signerad, tidsbegränsad URL – eller hoppa över kommandoraden och klistra in URL:en direkt i webbläsarens adressfält för att ladda ner den.

Ladda ner

model_urls.glb
curl -L "<model_urls.glb från svaret ovan>" -o model.glb
Den resulterande 3D-modellen som genererades från exempelbilden av katt
Ditt resultat

Filer lagras i 3 dagar på icke-Enterprise-planer – se tillgångslagring.

Sätt ihop allt

Föredrar du ett skript som gör allt – skapar, pollar, laddar ner?

Fullständigt skript

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. Skapa uppgiften
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 tills den är klar
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. Ladda ner resultatet
const { data: model } = await axios.get(task.model_urls.glb, { responseType: 'arraybuffer' });
fs.writeFileSync('model.glb', model);
console.log('Sparade model.glb');

Utforska vanliga arbetsflöden

Spelredo karaktär

Rigga ett humanoidnät med ett skelett så att det är redo att animeras i Unity eller Unreal.

Learn more →

Lowpoly tillgång

Sätt model_type till lowpoly på Bild till 3D för ett rent, spelredo nät.

Learn more →

3D-skriv ut modell

Konvertera en färdig modell till en flerfärg 3MF-fil, redo att skivas och skrivas ut.

Learn more →

Nästa steg

  • Föredrar du ett användargränssnitt? Prova API Playground — konfigurera en förfrågan, kör den, och kopiera den genererade koden.
  • Bläddra i hela API-referensen för varje endpoint.
  • Kontrollera Priser, Hastighetsbegränsningar och Fel innan du går till produktion.
  • Följ ändringsloggen för uppdateringar och buggfixar.
  • Har du feedback eller stöter på problem? Gå med i vår Discord community — vi skulle gärna höra från dig!