Polymosa Automation API

Ship 3D from your own code.

Three endpoints, one bearer token. Generate a textured model, poll it, download it in any format — the same engine as the studio, billed in the same credits. No subscription, no separate API plan.

Authentication

Every account has an API token — find yours in Account → API. Send it as a bearer header. Requests are limited to 30/minute.

Authorization: Bearer pm_your_token_here

Endpoints

EndpointWhat it does
POST/api/v1/generateStart a generation. Body: {"prompt": "...", "options": {"quality": "standard"}} (or "image" as base64 for image-to-3D). Returns job_id. Charges the tier's credits.
GET/api/v1/jobs/{id}Poll status: queued → running → done. Includes the download path when finished.
GET/api/v1/jobs/{id}/downloadThe file. ?format= glb (default) · stl · obj · ply · 3mf — free. fbx / usdz — 5 credits.

Quick start



  

Tiers & credits

QualityCreditsOutput
draft15Fast preview · 512px texture
standard30Balanced · 1K texture + glow
high60Sharper geometry · 2K texture
ultra4k1504K texture · pro reference
max4k300Native 4K geometry + texture — sharpest
Credits never expire and come from the same packs as the studio — see pricing. Failed generations refund automatically.