Reference
Go-live checklist
Ship with confidence — the short list that keeps production clean.
Key security#
| Field | Type | Description |
|---|---|---|
| Server-side only | must | Keep reb_live_ keys on your server. Never ship one in a browser bundle or mobile app. |
| One key per surface | should | Separate keys for prod, staging, and each integration — so you can revoke one without downing the rest. |
| Set a spend cap | must | Every key takes a cumulative USD cap (lifetime spend, not reset by invoicing). A capped key returns 402 instead of running away with your budget. |
| Rotate on leak | must | Revoke + recreate immediately if a key (or a ?key= MCP URL) is exposed. |
Polling & webhooks#
Most jobs are async: a submit returns a task id and a poll URL. For /v1/generate and Listing Enhance, poll GET /v1/tasks/{id} until status is succeeded or failed. Cinematic Reel is also async but returns a reel_id and its own poll_url (/v1/recipes/reel/{reel_id}) — poll that, not /v1/tasks. Lot Trace and Listing Kit return their result synchronously in the POST response, with no polling. Always follow the poll_url a submit hands back rather than assuming one path. Back off between polls (e.g. 2s, then 5s) — renders and reels can take a while, and store the id so a page reload can resume.
Error handling#
| Field | Type | Description |
|---|---|---|
| 401 | auth | Key missing/invalid/revoked — surface a clear re-auth path. |
| 402 | billing | Spend cap hit, or free trial spent with no card. Prompt to raise the cap or add a card. |
| 400 | input | Unknown/unavailable model or bad input — validate before you submit. |
| 502 / task failed | transient | Provider hiccup — safe to retry. Failed jobs are never billed. |
Rate limits#
Be a good citizen: cap your concurrency and retry with backoff on 429/502. See Rate limits for the current ceilings.
Moderation & fair housing#
REB is real-estate-first, so compliance is built in. Generated marketing copy runs through the same fair-housing filter as Studio — language implying a preferred buyer or steering is stripped. Photo edits correct light, color, sky and verticals without adding or removing features, so listings stay MLS-honest. You still own the final review before anything is published. See Compliance is built in.
Billing expectations#
Usage meters per successful call in USD and is invoiced monthly via Stripe — one hosted invoice for the period. Your first $5 is free; after that a card must be on file. Failed jobs cost nothing; internal (owner) keys aren't invoiced. Studio plans & credits are a separate product.