API

Generate UGC programmatically

The same pipeline that powers the Studio and the Roblox plugin is available over HTTP. Every call deducts credits from your Meshlox account.

1. Authentication

Create a token from your plugin page and send it as a bearer header on every request.

Authorization: Bearer mlx_xxxxxxxxxxxxxxxxxxxxxxxx

2. Start a generation

POST /api/public/plugin/generate — returns a job_id immediately.

curl -X POST https://meshlox.app/api/public/plugin/generate \
  -H "Authorization: Bearer mlx_xxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "stylized crimson dragon helmet, low-poly UGC",
    "mode": "image-to-3d",
    "image_url": "https://your.cdn/concept.png"
  }'

3. Poll for the result

GET /api/public/plugin/job/:id — returns status and, when finished, a signed model_url.

curl https://meshlox.app/api/public/plugin/job/JOB_ID \
  -H "Authorization: Bearer mlx_xxxxxxxxxxxxxxxxxxxxxxxx"

Error codes

401 — invalid or revoked token
402 — not enough credits, top up on the pricing page
429 — rate limited, retry with backoff
5xx — generation pipeline error; credits are refunded automatically