Build 3D into
your product
your product.
Turn any image into a textured, game-ready GLB with three REST endpoints. No ML expertise required — just an API key.
complete flow · three calls
# 1 — submitcurl -X POST https://api.spherelinks.com/generate \-H "X-API-Key: sk_live_••••••••••••" \-d '{"imageUrl": "https://example.com/shoe.jpg"}'# → { "jobId": "job_01j9xkb...", "status": "PROCESSING" }# 2 — pollcurl https://api.spherelinks.com/status/job_01j9xkb... \-H "X-API-Key: sk_live_••••••••••••"# → { "status": "COMPLETED", "progress": 100 }# 3 — downloadcurl -O model.glb \https://api.spherelinks.com/download/job_01j9xkb... \-H "X-API-Key: sk_live_••••••••••••"
/generateSubmit a job
Pass an image URL or base64 string. Get back a jobId immediately — generation is fully async.
/status/{jobId}Poll progress
Check progress 0–100. Status is PROCESSING → COMPLETED or FAILED. Poll every 5 s.
/download/{jobId}Download GLB
Receive the binary glTF file with PBR textures baked in. Ready for Three.js, Blender, Unity.
Submit
POST your image (URL or base64) with optional quality options. The server immediately returns a jobId — generation starts in the background.
curl -X POST https://api.spherelinks.com/generate \-H "X-API-Key: sk_live_••••••••••••" \-H "Content-Type: application/json" \-d '{"imageUrl": "https://example.com/shoe.jpg","options": { "textureSize": 1024 }}'# → { "jobId": "job_01j9xkb...", "status": "PROCESSING" }
Poll
GET /status/{jobId} every few seconds. progress goes from 0 to 100. Status transitions PROCESSING → COMPLETED (or FAILED).
curl https://api.spherelinks.com/status/job_01j9xkb... \-H "X-API-Key: sk_live_••••••••••••"# While processing# → { "status": "PROCESSING", "progress": 42 }# When done# → { "status": "COMPLETED", "progress": 100 }
Download
GET /download/{jobId} to receive the binary GLB. The file contains geometry + PBR textures baked in. Drop it into any engine.
curl -O model.glb \https://api.spherelinks.com/download/job_01j9xkb... \-H "X-API-Key: sk_live_••••••••••••"# model.glb saved — ready for Three.js, Blender, Unity...
api.spherelinks.com · X-API-Key: sk_live_…job statuses
PROCESSINGGeneration is runningCOMPLETEDGLB is ready to downloadFAILEDFailed — retry or contact supportHTTP errors
400Bad request — missing or invalid body401Missing or invalid API key402Insufficient credits422Could not fetch or decode the image502Upstream generation errorOne header. That's it.
Every request must include your API key in the X-API-Key header. Keys start with sk_live_ followed by 32 hex characters.
Keys are stored as SHA-256 hashes — even we can't read them back. Rotate your key any time from the settings page.
key format
usage
curl https://api.spherelinks.com/generate \-H "X-API-Key: sk_live_3f7a••••••••b2e9"
Game studios
Batch-convert concept art into game-ready assets. Works with Unity, Unreal Engine, and Godot pipelines.
E-commerce
Turn product photos into interactive 3D models. Embed with Three.js for try-before-you-buy experiences.
AR / VR apps
Generate room-scale objects from reference images. GLB is natively supported in WebXR, ARKit, ARCore.
Automation
Run batch generation inside CI/CD pipelines. Poll for completion, store GLBs in S3 — fully headless.
Pay only for what you generate.
Each generation consumes one credit. Free-tier accounts get 10 per month. Upgrade for higher limits and priority queue access.
Generate your first 3D model in minutes.
No credit card · Free to start · Cancel any time