Renderspace logoRenderspace

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.

Job-site exterior photo before redesign
Before
Photorealistic exterior concept generated in Renderspace
After

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

  1. Use an active Professional or Business subscription.
  2. Open Profile → API Keys.
  3. Create a key and store the secret — it is shown once.
  4. Send Authorization: Bearer rs_live_…
Open profile

Endpoints

MethodPathPurpose
GET/api/v1/creditsRemaining credits
POST/api/v1/rendersCreate a render (sync, 2 credits)
GET/api/v1/rendersList 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.failed or webhook.test
  • X-Renderspace-Timestamp: Unix seconds
  • X-Renderspace-Signature: sha256= HMAC of timestamp.body using your whsec_ 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.