REST API — v1

Build 3D into
your product

Turn any image into a textured, game-ready 3D model via three simple REST endpoints. No ML expertise required — just an API key.

~60s
avg. generation
3
endpoints
GLB
output format

Everything you need

A minimal, production-ready API for integrating AI-powered 3D generation into any stack.

Async generation

Submit a job and poll for completion. No timeouts, no webhooks required — works with any HTTP client.

Simple REST

Three endpoints, JSON in, GLB out. No SDK, no complex setup — just standard HTTP with an API key header.

GLB output

Every model is delivered as a binary glTF (.glb) with textures baked in, ready for Three.js, Unity, Blender, or Unreal.

Tunable quality

Control texture resolution (512–2048 px), mesh simplification, and diffusion steps to trade speed for fidelity.

Secure by default

All requests are authenticated via an API key. Keys are scoped per account and can be rotated any time from your dashboard.

Any input source

Pass a public image URL or a base64-encoded image directly. JPEG, PNG, and WebP are supported up to 10 MB.

Three steps, one GLB

The complete flow from image to 3D model.

01

Submit a generation job

POST your image (as a URL or base64) along with optional quality settings. The API immediately returns a jobId.

bash
curl -X POST https://api.spherelinks.io/v1/generate \
-H "X-API-Key: sk-your-api-key" \
-H "Content-Type: application/json" \
-d '{
"imageUrl": "https://example.com/shoe.jpg",
"options": {
"textureSize": 1024,
"simplifyRatio": 0.95
}
}'
# Response
{
"jobId": "job_01j9xkb...",
"status": "PROCESSING",
"message": "Generation started."
}
02

Poll for completion

GET the status endpoint with your jobId every few seconds. Progress is reported from 0–100 while the model is being built.

bash
# 2. Poll for completion
curl https://api.spherelinks.io/v1/status/job_01j9xkb... \
-H "X-API-Key: sk-your-api-key"
# Response (while processing)
{
"jobId": "job_01j9xkb...",
"status": "PROCESSING",
"progress": 42,
"description": "Generating mesh..."
}
# Response (done)
{
"jobId": "job_01j9xkb...",
"status": "COMPLETED",
"progress": 100
}
03

Download the GLB

When status is COMPLETED, GET the download endpoint to receive the textured GLB file — ready to render anywhere.

bash
# 3. Download the GLB
curl -O output.glb \
https://api.spherelinks.io/v1/download/job_01j9xkb... \
-H "X-API-Key: sk-your-api-key"
# File saved as output.glb — ready for Three.js, Blender, Unity...

API reference

Base URL: https://api.spherelinks.io/v1All requests require the X-API-Key header.

Job statuses

PROCESSINGModel is being generated
COMPLETEDGLB is ready to download
FAILEDGeneration failed; retry or contact support

HTTP error codes

400Bad request — missing or invalid body
401Missing or invalid API key
402Insufficient credits
422Could not fetch or parse the provided imageUrl
502Upstream generation error

Built for every workflow

From indie games to enterprise e-commerce.

🎮

Game studios

Batch-convert concept art or photo scans into game-ready assets. Works with Unity, Unreal, and Godot asset pipelines.

🛒

E-commerce

Turn product photos into interactive 3D models. Embed in product pages with Three.js for a try-before-you-buy experience.

🏗️

AR / VR apps

Generate room-scale objects from reference images. GLB is natively supported in WebXR, ARKit, and ARCore.

⚙️

Automation pipelines

Run batch 3D generation inside CI/CD or data pipelines. Poll for completion, store GLBs in S3 — fully headless.

Credit-based pricing

Pay only for what you generate

Each generation consumes credits from your account. Free-tier users get 10 credits per month. Upgrade for higher limits and priority queue access.

Start building today

Create a free account, grab your API key from the settings page, and generate your first 3D model in minutes.