API reference

Generate 3D programmatically.

REST endpoints with predictable resource URLs, form-encoded request bodies, JSON responses, standard HTTP codes. Webhooks for long-running tasks.

Get API key See pricing

Authentication

Bearer tokens

All API requests require an Authorization header with a bearer token. Generate keys in your dashboard.

curl -X POST https://api.polyx.digital/v1/text-to-3d \
  -H "Authorization: Bearer plx_live_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"mode":"preview","prompt":"a stylised low-poly fox"}'

Endpoints

Six pipelines, one API

POST/v1/text-to-3d20 credits

Text → 3D

Generate a 3D mesh from a natural-language prompt. Supports preview (mesh-only) and refine (textured) stages.

{
  "mode": "preview",
  "prompt": "stylised fox warrior with armor",
  "model_type": "standard",
  "symmetry_mode": "auto",
  "target_formats": ["glb", "fbx"]
}

POST/v1/image-to-3d30 credits

Image → 3D

Turn a single reference image into a 3D model with PBR textures.

{
  "image_url": "https://...",
  "enable_pbr": true,
  "target_polycount": 10000
}

POST/v1/multi-image-to-3d15 credits

Multi-Image → 3D

Provide multiple views (front / side / top) for higher-fidelity reconstruction.

{
  "image_urls": ["url-front.jpg", "url-side.jpg"],
  "enable_pbr": true
}

POST/v1/retexture10 credits

AI Texturing

Re-texture an existing mesh with new PBR materials. Provide either a text prompt or a style image.

{
  "model_url": "https://.../mesh.glb",
  "texture_prompt": "rusted metal, red highlights",
  "hd_texture": true
}

POST/v1/remesh5 credits

Remesh

Optimise topology and polycount. Quad-dominant retopology, clean edge flow.

{
  "model_url": "https://.../scan.obj",
  "target_polycount": 5000,
  "target_formats": ["glb", "fbx", "obj"]
}

POST/v1/animation8 credits

Auto-Rig + Animation

Automatically rig a humanoid or quadruped character and apply animations from our library.

{
  "model_url": "https://.../character.glb",
  "rig_type": "humanoid",
  "animations": ["idle", "walk", "run"]
}

Rate limits

Tiered concurrency

Tier	Requests/sec	Concurrent queue	Priority
Free	—	—	—
Pro	20	Up to 10	Default
Studio	20	Up to 20	Higher
Enterprise	100+	50+	Highest · 99.9% SLA

Exceeding limits returns 429 Too Many Requests.

Webhooks

Real-time task events

Configure a webhook URL in your dashboard to receive POST notifications when tasks change state (PENDING, IN_PROGRESS, SUCCEEDED, FAILED). HMAC-SHA256 signed.

{
  "event": "task.succeeded",
  "task_id": "tsk_01HC...",
  "type": "text-to-3d-refine",
  "model_urls": {
    "glb": "https://cdn.polyx.digital/...",
    "fbx": "https://cdn.polyx.digital/..."
  },
  "thumbnail_url": "https://cdn.polyx.digital/...",
  "finished_at": 1714060800000
}

Ready to ship?

Pro tier and above unlock API access. Your first 5 credits are on us.

Start free Talk to sales