Hoe gebruik je de Image to 3D Model API: Een complete gids 2026

De Image to 3D Model API zet een enkele foto om in een productieklaar 3D-model in seconden—zonder handmatig modelleren. Handmatig elk asset modelleren is traag en duur, en voor gamestudio's, AR-apps en e-commerce teams wordt het al snel de flesnek die lanceringen vertraagt. Meshy's image-to-3D model API verwijdert die wrijving: stuur een afbeelding, converteer deze naar een 3D-model in seconden, en download een volledig getextureerd mesh in formaten zoals GLB, FBX en OBJ. Deze gids leidt je door de volledige workflow—van het aanmaken van je API-sleutel tot het downloaden van je eerste model—met kopieer-plak-code die je in minuten kunt uitvoeren.

Wat is de Image to 3D Model API?

In de kern is de Image to 3D Model API een REST-endpoint aangedreven door Meshy's image-to-3D model AI. Je stuurt een enkele afbeelding (JPG, JPEG of PNG) als een openbare URL of base64-string, en de API retourneert een getextureerd 3D-model—inclusief geometrie en basiskleurtexturen—in standaardformaten zoals GLB, FBX, OBJ, USDZ, STL en 3MF. Optionele toevoegingen zijn PBR-kaarten, tot 4K-texturen en voorbeeldminiaturen vanuit meerdere hoeken.

Aangedreven door ons nieuwste Meshy 6-model, laat de API je topologie en polygonenaantallen configureren, posemodi instellen en texturering sturen met een tekstprompt of referentieafbeelding—ideaal voor het genereren van assets voor games, AR/VR, 3D-printen en productvisualisatie.

Wat heb je nodig om de Image to 3D API te gebruiken?

Je hebt niet veel nodig om deze gids te volgen. Zorg dat je het volgende hebt:

• Een Meshy-account — meld je gratis aan als je er nog geen hebt. Je genereert je API-sleutel vanuit het dashboard in Stap 1.

• Een API-sleutel — gebruikt om elk verzoek te authenticeren. We lopen door het aanmaken ervan, en je kunt de gratis testmodus-sleutel gebruiken om mee te doen zonder credits te verbruiken.

• Een invoerafbeelding — een duidelijke .jpg, .jpeg of .png gehost op een openbaar toegankelijke URL (of gecodeerd als base64). Een schone achtergrond en een duidelijk zichtbaar onderwerp geven de beste resultaten.

• Een manier om HTTP-verzoeken te doen — curl (gebruikt in de onderstaande voorbeelden), Postman, of een HTTP-bibliotheek in de programmeertaal van je keuze. Basiskennis van REST API's en JSON is handig maar niet vereist.

Dat is alles—geen 3D-modelleerervaring nodig. Laten we beginnen.

Hoe converteer je een afbeelding naar een 3D-model met de API (Stap-voor-stap handleiding)

Stap 1: Stel je API-instellingen in

Alles wat je nodig hebt om te beginnen bouwen, vind je op de API-instellingenpagina. Dit is je controlekamer voor de Meshy API, en het heeft drie belangrijke secties:

• API-sleutels — genereer en beheer de sleutels die je verzoeken authenticeren.

• Webhooks — krijg automatisch een melding wanneer je taken zijn voltooid.

• Gebruik — volg je resterende creditsaldo en API-verbruik in realtime.

Laten we ze allemaal doornemen.

Haal je API-sleutel op

Voordat je verzoeken doet, heb je een API-sleutel nodig om veilig te authenticeren. Klik op de API-instellingenpagina op API-sleutel genereren. Elke sleutel volgt het formaat msy-<willekeurige-tekenreeks>.

Tip: Bewaar je API-sleutel na het genereren op een veilige plek (bijv. een wachtwoordmanager of omgevingsvariabele). Behandel het als een wachtwoord—commit het nooit naar versiebeheer of stel het bloot in client-side code.

Testmodus API-sleutel

Tijdens ontwikkeling en testen kun je de testmodus API-sleutel gebruiken om de API te verkennen zonder je credits te verbruiken:

msy_dummy_api_key_for_test_mode_12345678

Deze speciale sleutel heeft de volgende kenmerken:

• Hij kan worden gebruikt om verzoeken te doen naar alle Meshy API-endpoints.

• Geen credits worden verbruikt bij gebruik van deze sleutel.

• Alle geldige verzoeken retourneren het zelfde voorbeeldtaakresultaat, ongeacht de invoerparameters.

• De responsdatastructuur komt exact overeen met de productie-API.

Dit maakt het perfect voor het testen van je integratie voordat je overschakelt naar je echte API-sleutel.

Webhooks instellen (Optioneel)

Het genereren van een 3D-model kost tijd, dus in plaats van herhaaldelijk de API te pollen om te controleren of een taak klaar is, kun je Meshy je laten waarschuwen op het moment dat het klaar is. Dat is waar webhooks voor dienen.

Voeg in de sectie Webhooks van de instellingenpagina een endpoint-URL toe waar Meshy gebeurtenismeldingen naartoe moet sturen. Wanneer een taak van status verandert (bijvoorbeeld wanneer deze wordt voltooid of mislukt), stuurt Meshy een HTTP POST-verzoek naar jouw URL met de taakdetails in de payload.

Tip: Webhooks zijn de aanbevolen aanpak voor productie. Ze verminderen onnodige API-aanroepen en laten je applicatie in realtime reageren op resultaten. Voor snelle tests werkt pollen nog steeds prima. Om webhook-code lokaal te testen, kun je deze richten op een proxy-URL van een service zoals smee.io.

Probeer het zonder code — API Playground (Optioneel)

Heb je al je API-sleutel? Voordat je code schrijft, kun je een echte Image to 3D-taak rechtstreeks in je browser uitvoeren.

Open meshy.ai/api-playground, selecteer Image to 3D in het linkerpaneel en vul drie dingen in:

1. Authorization — plak je API-sleutel (msy-xxxxxxxxxx)

2. Image — upload een .jpg, .jpeg of .png van je computer

3. Druk op Send

De Playground verzendt de taak en polt automatisch naar resultaten. Zodra het klaar is, zie je de 3D-modelvoorbeeld en downloadlinks direct in de browser — geen code vereist.

Pro tip: Het onbewerkte verzoek/responspaneel aan de rechterkant laat precies zien wat de API verzendt en retourneert. Je kunt de inhoud direct kopiëren — pak de task_id uit de respons, en de model_urls zodra de taak is voltooid. Je gebruikt beide in de volgende stappen.

Stap 2: Verzend een Image to 3D-taak

Met je API-sleutel klaar, start je een taak met een enkel POST-verzoek:

curl -X POST https://api.meshy.ai/openapi/v1/image-to-3d \
  -H "Authorization: Bearer $MESHY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://example.com/your-image.png"
  }'

Je krijgt een respons zoals deze terug:

{
  "result": "018a210d-8ba4-705c-b111-1f1776f7f578"
}

Die result-waarde is je task_id — bewaar deze. Je hebt hem in de volgende stap nodig om de voortgang te controleren en je model op te halen.

Optioneel: Om automatisch een melding te krijgen wanneer de taak is voltooid, voeg je een webhook_url-veld toe aan de JSON-body—bijvoorbeeld "webhook_url": "https://yourapp.com/webhooks/meshy". Zie Stap 3, Optie B voor hoe het werkt.

Stap 3: Haal je resultaten op

Je taak is niet direct klaar—Meshy verwerkt het op de achtergrond. Je hebt twee manieren om het resultaat te krijgen:

Optie A: Poll voor status (Eenvoudigst)

Stuur elke 5 seconden een GET-verzoek totdat status verandert naar SUCCEEDED:

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

De respons ziet er zo uit:

{
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "status": "SUCCEEDED",
  "progress": 100,
  "model_url": "https://assets.meshy.ai/.../model.glb",
  "model_urls": {
    "glb": "https://assets.meshy.ai/.../model.glb",
    "fbx": "https://assets.meshy.ai/.../model.fbx",
    "obj": "https://assets.meshy.ai/.../model.obj",
    "usdz": "https://assets.meshy.ai/.../model.usdz",
    "stl": "https://assets.meshy.ai/.../model.stl",
    "mtl": "https://assets.meshy.ai/.../model.mtl"
  },
  "thumbnail_url": "https://assets.meshy.ai/.../thumbnail.png",
  "consumed_credits": 30
}

Een paar velden die het weten waard zijn:

• model_urls bevat een downloadlink voor elk gegenereerd formaat. Standaard omvat dit glb, fbx, obj, usdz, stl en mtl (het materiaalbestand dat bij obj hoort).

• model_url is een snelkoppeling naar de GLB-link—handig als je alleen GLB nodig hebt.

• consumed_credits toont hoeveel credits de taak heeft gebruikt (het is 0 voor mislukte taken, omdat credits worden terugbetaald).

• thumbnail_url is altijd aanwezig en verwijst naar de vooraanzicht-miniatuur.

• thumbnail_urls verschijnt alleen wanneer multi_view_thumbnails: true, en bevat de voor-, rechts-, achter- en linkeraanzichten.

• alpha_thumbnail_url verschijnt alleen wanneer alpha_thumbnail: true, en bevat de miniatuur met transparante achtergrond.

Mogelijke status-waarden: PENDING → IN_PROGRESS → SUCCEEDED / FAILED / CANCELED

Optie B: Webhook (Aanbevolen voor productie)

Als je in Stap 2 een webhook_url hebt ingesteld, stuurt Meshy het voltooide taakobject automatisch naar jouw URL—geen polling nodig.

{
  "image_url": "https://example.com/your-image.png",
  "webhook_url": "https://yourapp.com/webhooks/meshy"
}

💡 Welke moet ik gebruiken? Pollen is prima voor prototypen en eenmalige taken. Gebruik webhooks in productie — het is betrouwbaarder en bespaart API-aanroepen.

Stap 4: Download je 3D-model

Zodra status SUCCEEDED is, pak je de download-URL's uit model_urls en download je het formaat dat je nodig hebt:

curl -o model.glb "https://assets.meshy.ai/.../model.glb"

De vlag -o model.glb slaat het bestand op in je huidige werkmap onder die naam—gebruik een volledig pad (bijv. -o /path/to/model.glb) om het ergens anders op te slaan.

Standaard retourneert elke taak GLB, FBX, OBJ, USDZ, STL en MTL (het materiaalbestand voor OBJ). 3MF is opt-in—je krijgt het alleen wanneer je er expliciet om vraagt via target_formats (zie de parametertabel hieronder).

⚠️ Links verlopen na 3 dagen (Enterprise-abonnementen krijgen permanente links). Download en bewaar je modellen snel — de links werken niet meer na het verlopen, en je moet de taak opnieuw uitvoeren.

Klaar om dit model te gebruiken in je DCC-tool? Zie de Bridge to Blender-handleiding—Meshy heeft ook bridges voor Unity, Unreal, Maya en meer.

Hoe krijg je de beste image-to-3D-resultaten?

• Gebruik een enkel, duidelijk zichtbaar onderwerp. Eén hoofdobject, gecentreerd en volledig in beeld, geeft de AI de schoonste referentie—vermijd drukke scènes, zware bijsnijdingen en extreme hoeken.

• Geef de voorkeur aan een schone, opgeruimde achtergrond. Effen of eenvoudige achtergronden helpen het model het onderwerp van zijn omgeving te scheiden.

• Gebruik gelijkmatige, diffuse verlichting. Harde schaduwen en sterke hooglichten kunnen misleidende details in de gegenereerde textuur bakken.

• Begin met een hoge-resolutie, scherpe afbeelding. Meer detail erin staat gelijk aan meer detail eruit—wazige of lage-resolutie invoer produceert zachtere modellen.

Welke programmeertalen kan ik gebruiken met de Image to 3D API?

Elke taal die HTTP-verzoeken kan doen—je stuurt een POST met JSON en polt met GET. Veelvoorkomende opties:

• Python — gebruik de requests- of httpx-bibliotheek

• JavaScript / TypeScript — gebruik fetch (ingebouwd) of axios

• Go — gebruik net/http uit de standaardbibliotheek

• cURL — geweldig voor snel testen vanaf de terminal

Je kunt ook kant-en-klare codevoorbeelden voor alle vier vinden in de API Playground.

Hoeveel credits kost een Image to 3D-taak?

De kosten zijn afhankelijk van de modelversie en of je texturen genereert. De standaardconfiguratie (meshy-6 met texturering) kost 30 credits per taak:

Mislukte taken worden automatisch terugbetaald—consumed_credits retourneert 0. Controleer altijd Prijzen voor de meest actuele tarieven.

Welke parameters accepteert de Image to 3D API?

Stuur een POST naar /openapi/v1/image-to-3d met deze parameters: Vereist (een van):

Optioneel:

Volgende stappen met de Image to 3D API

Je hebt nu de volledige workflow: maak een API-sleutel aan, verzend een afbeelding, pol of gebruik een webhook voor het resultaat, en download vervolgens je model. Dezelfde vier stappen schalen van een snel prototype tot een productiepijplijn die duizenden afbeeldingen automatisch omzet in 3D-assets. Haal je sleutel op van de API-instellingenpagina en lever vandaag nog je eerste model. Liever beginnen met een prompt in plaats van een foto? Gebruik de Text to 3D Model API.

Veelgestelde vragen

Hoe converteer ik een afbeelding naar een 3D-model via de API?

Stuur een POST-verzoek naar /openapi/v1/image-to-3d met je image_url en API-sleutel, en pol vervolgens de taak (of gebruik een webhook) totdat de status SUCCEEDED is. De respons retourneert downloadlinks voor het gegenereerde model. De volledige vierstappenstroom—sleutel, verzenden, ophalen, downloaden—wordt behandeld in de stap-voor-stap handleiding hierboven.

Welke uitvoerformaten (STL, GLB, OBJ) ondersteunt de API?

Elke taak retourneert standaard GLB, FBX, OBJ, USDZ, STL en MTL, met 3MF beschikbaar op verzoek via target_formats. GLB is het beste voor web en AR, FBX en OBJ voor DCC-tools en game-engines, USDZ voor iOS AR, en STL voor 3D-printen.

Welke afbeeldingsformaten kan ik uploaden?

De Image to 3D API ondersteunt JPG-, JPEG- en PNG-afbeeldingen tot 100 MB—groter dan de 20 MB-limiet in de Meshy Werkruimte-interface. Gebruik voor de meest nauwkeurige resultaten een PNG met een transparante of schone witte achtergrond, wat de API helpt het onderwerp te isoleren en een 3D-model van hogere kwaliteit te genereren.

Kan ik een getextureerd 3D-model krijgen van de API?

Ja. Texturering is standaard ingeschakeld ("should_texture": true). Om PBR-kaarten (metallic, roughness, normal) toe te voegen, stel je "enable_pbr": true in—op meshy-6/latest wordt dan ook een emissiekaart meegeleverd. Voor een 4K-basiskleurtextuur stel je "hd_texture": true in (alleen ondersteund op meshy-6/latest; PBR-kaarten blijven 2K). Je kunt de textuurstijl ook sturen met een texture_prompt of een texture_image_url.

Kan ik een 3D-model genereren dat klaar is voor 3D-printen (STL)?

Ja—STL wordt standaard gegenereerd, dus een image-to-3D STL-conversie heeft geen extra parameters nodig: pak gewoon model_urls.stl wanneer de taak is voltooid. Dat maakt image-to-3D-printworkflows eenvoudig, aangezien STL het standaardformaat is dat slicers verwachten. Als je alleen STL wilt, stel dan "target_formats": ["stl"] in om de andere formaten over te slaan en de generatietijd te verkorten.

Welke abonnementen omvatten API-toegang?

API-toegang is beschikbaar op Pro-, Studio- en Enterprise-abonnementen—het is een functie voor Pro en hoger. Het gratis Starter-abonnement biedt geen API-toegang. Zie Prijzen voor details.

Hoe lang zijn downloadlinks geldig?

Downloadlinks zijn 3 dagen geldig op Pro- en Studio-abonnementen. Enterprise-klanten krijgen permanente links. Bewaar je bestanden snel—verlopen links kunnen niet worden hersteld en je moet de taak opnieuw uitvoeren.

Kan ik meerdere taken tegelijk uitvoeren?

Ja, gelijktijdige verzoeken worden ondersteund. Als je een 429 Too Many Requests-fout krijgt, heeft je account de snelheidslimiet bereikt—implementeer exponentiële backoff en probeer het opnieuw. Zie de Snelheidslimieten-pagina voor de limieten van jouw abonnement.

De taak toont FAILED — wat moet ik doen?

Controleer task_error.message voor de oorzaak. Veelvoorkomende:

Als het probleem aanhoudt, neem dan contact op met Meshy-ondersteuning.