API for virtual staging, floor plans, CAD and architecture renders

Real outputs

Inputs on the left, API results on the right. Same models and prompts as the AI Architectures apps.

Endpoints

Image inputs: image_url (public https) or image (base64), JPEG/PNG/WebP/HEIC up to 15 MB. Options for every endpoint: resolution 2k|4k, aspect_ratio (auto keeps the photo's), webhook_url, metadata. Full schema: openapi.json; option lists: /v1/options.

Quickstart

1. Sign in and create a key at developers/dashboard. Start with a sandbox key (sk_test_…): same API, sample outputs, no credits. 2. Create a job. 3. Poll it or receive a webhook. 4. Download the files.

# 1. Create a job (sandbox key: free sample output; live key: real result)
curl https://api.20.vision/v1/virtual-staging \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: listing-4711-photo-3" \
  -d '{
    "image_url": "https://example.com/listing/empty-living-room.jpg",
    "style": "scandinavian",
    "room_type": "living room"
  }'
# -> 202 {"id":"job_5f2c...","status":"queued", ...}

# 2. Poll it (or use a webhook, below)
curl https://api.20.vision/v1/jobs/job_5f2c... -H "Authorization: Bearer $API_KEY"
# -> {"status":"succeeded","credits_charged":100,
#     "output":{"images":[{"url":"https://api.20.vision/v1/files/job_5f2c.../result.jpg?expires=...&signature=...", ...}]}}

# Short jobs in one call: wait up to 90 s for the result
curl "https://api.20.vision/v1/renders?wait=90" -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" -d '{"image_url":"https://example.com/sketch.png","lighting":"golden_hour"}'

Jobs, idempotency and limits

• Every POST answers 202 with a job: queued → running → succeeded | failed. Add ?wait=90 (or Prefer: wait=90) to get the finished job in the same response when it is done in time.
• Send an Idempotency-Key header on every POST. A retry with the same key and body returns the original job and is never charged twice; the same key with another body answers 409.
• Credits are checked before a job starts (402 insufficient_credits) and charged only for succeeded work. credits_charged is on every job.
• Rate limits per key: 300 requests and 60 job creations per minute (sandbox 120 / 30). Headers X-RateLimit-*; a 429 carries Retry-After. Up to 8 image and 4 CAD jobs run at once per account; more wait in the queue.
• Download links are signed for 24 hours; GET /v1/jobs/{id} returns fresh ones. Images come as JPEG, PNG or WebP; CAD as DXF, DWG, PDF and PNG.

Webhooks

Add endpoints in the dashboard or with POST /v1/webhooks (https only). Each finished job sends job.succeeded or job.failed with the full job; a job's own webhook_url receives it too. Signatures follow the Standard Webhooks spec (headers webhook-id, webhook-timestamp, webhook-signature; secret whsec_… per account and mode). Failed deliveries are retried after 5 s, 30 s and 2 min.

// Express: verify the signature on the raw body (Standard Webhooks)
import crypto from 'node:crypto';
app.post('/hooks/ai', express.raw({ type: 'application/json' }), (req, res) => {
  const id = req.header('webhook-id'), ts = req.header('webhook-timestamp');
  const key = Buffer.from(process.env.WEBHOOK_SECRET.replace(/^whsec_/, ''), 'base64');
  const expected = 'v1,' + crypto.createHmac('sha256', key).update(`${id}.${ts}.${req.body}`).digest('base64');
  const ok = req.header('webhook-signature').split(' ').some((s) => s === expected);
  if (!ok || Math.abs(Date.now() / 1000 - Number(ts)) > 300) return res.sendStatus(400);
  const event = JSON.parse(req.body);         // { id, type: 'job.succeeded' | 'job.failed', data: job }
  res.sendStatus(200);                         // answer fast, then process
});

Sandbox

Sandbox keys run the whole flow (validation, queue, webhooks, signed files, rate limits) and return sample outputs without spending credits. The job shows credits_estimate: what it would cost live. Force outcomes with "simulate": "failed" or "insufficient_credits" to test your error handling.

Pricing

The API uses the credits of your AI Architectures account, at the same rates as the apps. Any plan works; failed jobs are free.

CAD jobs cost their real usage, minimum 300 and at most 2,500 credits (revisions 60-1,200). Plans: pricing. Volume API plans with lower per-call prices and invoicing: email [email protected].

White-label terms

• Outputs carry no AI Architectures name, logo or watermark; CAD sheets have no third-party credit line; download links are on the neutral domain api.20.vision.
• You may use, edit and resell outputs under your own brand, and offer the features in your product without naming us.
• Images keep a neutral machine-readable "AI-generated" EXIF marking (EU AI Act Art. 50). Where listing rules require disclosure of virtually staged or edited photos (for example California AB 723), disclosure is your and your customer's responsibility.
• Do not use the API to mislead buyers about a property's condition, for unlawful content, or to resell raw API access as a competing API.
• Images and drawings are concepts, not construction documents, and need professional review before anything is built. Your use is governed by the Terms of Service.

Service levels

• Availability target: 99.5% per calendar month for job creation, job status and file downloads, measured at api.20.vision, excluding announced maintenance and third-party outages beyond our control.
• Jobs that fail are not charged. A job that has not finished within 24 hours is marked failed and refunded.
• Support: email [email protected], reply within one business day (CET). Incidents and changes that break compatibility are announced by email to key owners; v1 stays backward compatible (new fields may be added).
• A contractual SLA with service credits, a dedicated contact and custom limits is available on volume API plans.

Errors

Errors are JSON: {"error":{"code":"insufficient_credits","message":"…","status":402}}.

Tools and integrations

• OpenAPI 3.1 spec: import into Postman, Insomnia or an SDK generator. Ready-made Postman collection (set apiKey to your sandbox key).
• No-code: Zapier and Make connect through POST /v1/webhooks (job finished) and the create endpoints.
• Questions or a custom workflow (MLS export, brand style presets, bulk import): [email protected].

FAQ