Render from any tool

Open Settings → API keys, create a key and copy it (it is shown once). Keys carry your account's credits and plan — treat them like passwords.

Send your key as a bearer token on every request:

Authorization: Bearer tds_live_XXXXXXXX

Verify it with GET /api/v1/me, which returns your plan and credit balance.

POST /api/v1/renders with the source view as image_url (already hosted) or image_base64 (a viewport capture). The call blocks until the model finishes and returns the result.

curl -X POST https://threedimensions.studio/api/v1/renders \
  -H "Authorization: Bearer tds_live_XXXXXXXX" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://example.com/my-viewport.png",
    "scene_type": "exterior",
    "resolution": "2k",
    "architectural_style": "Modern",
    "lighting": "Golden Hour",
    "prompt": "warm evening light, lush landscaping",
    "source": "api"
  }'

{
  "render": {
    "id": "…",
    "status": "done",
    "output_image_url": "https://…/render.jpg",
    "credits_used": 10
  },
  "credits": 90
}

Other operations: set kind to refine, enhance, staging or video. Fetch the full option lists (styles, lighting, costs) from GET /api/v1/styles.

The plugins capture your active view and call this same API. Source and build instructions live in the repository under /plugins.

Errors use { "error": { "code", "message" } }. 401 = bad key, 402 = out of credits, 400 = bad request. Credits are spent only on success and automatically refunded if a model call fails.