Public API
Photo in. Concept out.
Turn a job-site photo into a photorealistic design concept from your own tools. Natural-language instructions are structured on our servers. Professional and Business plans only. Each successful API render uses 2 credits.


Try a request
Authenticate with a key from your profile. Pass an image URL or multipart upload plus a natural-language instruction.
curl -X POST https://www.renderspace.ai/api/v1/renders \
-H "Authorization: Bearer rs_live_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"space_type": "landscape",
"image_url": "https://example.com/yard.jpg",
"instruction": "Modern backyard with a linear pool and warm evening light"
}'Get a key
- Use an active Professional or Business subscription.
- Open Profile → API Keys.
- Create a key and store the secret — it is shown once.
- Send
Authorization: Bearer rs_live_…
Endpoints
| Method | Path | Purpose |
|---|---|---|
| GET | /api/v1/credits | Remaining credits |
| POST | /api/v1/renders | Create a render (sync, 2 credits) |
| GET | /api/v1/renders | List recent renders |
| GET | /api/v1/renders/{id} | Fetch one render |
Machine-readable contract: /openapi/v1.yaml
Webhooks
POST /renders answers synchronously, so you don't need webhooks. Add one in Profile → Webhooks if another tool (n8n, Make, Zapier) should hear about every finished render. Each delivery is a JSON POST with these headers:
X-Renderspace-Event:render.completed,render.failedorwebhook.testX-Renderspace-Timestamp: Unix secondsX-Renderspace-Signature:sha256=HMAC oftimestamp.bodyusing yourwhsec_secret
import { createHmac, timingSafeEqual } from "node:crypto"
// rawBody: the request body exactly as received (string), before JSON.parse
function verifyRenderspace(rawBody, headers, secret) {
const ts = headers["x-renderspace-timestamp"]
if (!ts || Math.abs(Date.now() / 1000 - Number(ts)) > 300) return false
const expected =
"sha256=" + createHmac("sha256", secret).update(`${ts}.${rawBody}`).digest("hex")
const got = headers["x-renderspace-signature"] || ""
return got.length === expected.length &&
timingSafeEqual(Buffer.from(got), Buffer.from(expected))
}One attempt per event with an 8-second timeout and no retries. If you miss one, fetch GET /renders/{id}. HTTPS only, up to 5 per account.
Terms & commercial use
API access requires an active Professional or Business plan. Each successful API render costs 2 credits.
API renders inherit your paid-plan commercial license. Use renders in proposals, presentations, your website, social media and ads. Reselling or licensing the images themselves to third parties is not allowed.