Reference
API Reference
Rendered live from our OpenAPI 3.1 spec — the same file served at /openapi.json.
/v1/generateRun an engine
Submit a generation on any live engine. Returns a task id + poll URL. Billed on success only.
Request body
model*string — Engine id (see /v1 live models).flux-ultra · gemini-image · gpt-image · seedream-4 · flux-schnell · flux-dev · recraft-v3 · kontext · +33 morepromptstring — Text prompt, when the engine takes one.image_urlstring · uri — Input image, for image→image / image→video engines.video_urlstring · uri — Input video, for video→video engines.audio_urlstring · uri — Input audio, where applicable.paramsobject — Engine-specific parameters.
Responses
202— Job queued400— Unknown/unavailable model or bad input401— Invalid or missing API key402— Spend cap reached, or free trial exhausted with no card on file502— Provider submit failed
/v1/tasks/{id}Get a task
Poll a job by id. When succeeded, returns the output URLs and the billed cost.
Path parameters
id* — Task id from a submit call
Responses
200— Task state401— Invalid or missing API key404— Task not found for this key
POST /v1/recipes/listing-enhanceListing Enhance
Raw interior/exterior/drone photo → MLS-grade edit, tuned to the REB look.
Request body
promptstringimage_urlstring · uriparamsobject
Responses
202— Job queued400— Bad request — missing or invalid input401— Invalid or missing API key402— Spend cap reached, or free trial exhausted with no card on file
POST /v1/recipes/lot-traceLot Trace
Aerial photo + boundary points → parcel isolation with an acreage callout.
Request body
promptstringimage_urlstring · uriparamsobject
Responses
202— Job queued400— Bad request — missing or invalid input401— Invalid or missing API key402— Spend cap reached, or free trial exhausted with no card on file
POST /v1/recipes/reelCinematic Reel
Listing photos or raw clips → a post-ready cinematic reel with captions.
Request body
promptstringimage_urlstring · uriparamsobject
Responses
202— Job queued400— Bad request — missing or invalid input401— Invalid or missing API key402— Spend cap reached, or free trial exhausted with no card on file
POST /v1/recipes/listing-kitListing Kit
Listing details + photos → flyer, social, story, captions — brand-locked.
Request body
promptstringimage_urlstring · uriparamsobject
Responses
202— Job queued400— Bad request — missing or invalid input401— Invalid or missing API key402— Spend cap reached, or free trial exhausted with no card on file
POST /v1/generateEngine passthrough
Call any engine in the arsenal directly by id — the raw multi-engine passthrough.
Request body
promptstringimage_urlstring · uriparamsobject
Responses
202— Job queued400— Bad request — missing or invalid input401— Invalid or missing API key402— Spend cap reached, or free trial exhausted with no card on file
Authentication#
Every endpoint takes your key as a Bearer token: Authorization: Bearer reb_live_…. Create one in the Developer Console.
