API Reference

Run 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 · +45 more
• promptstring — 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 queued
• 400 — Unknown/unavailable model or bad input
• 401 — Invalid or missing API key
• 402 — Spend cap reached, or free trial exhausted with no card on file
• 502 — Provider submit failed

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 state
• 401 — Invalid or missing API key
• 404 — Task not found for this key

Listing Enhance

Raw interior/exterior/drone photo → MLS-grade edit, tuned to a premium, listing-ready edit. Async — poll GET /v1/tasks/{id} until it succeeds or fails.

Request body

• image_urlstring · uri — Input image (single-image recipes).
• photosarray — Input photos (Listing Kit, Cinematic Reel).
• detailsobject — Listing details (Listing Kit, Cinematic Reel).
• pointsarray — Boundary points in image pixels (Lot Trace).
• notesstring — Extra edit guidance, where the recipe accepts it.

Responses

• 202 — Job queued — poll /v1/tasks/{id}
• 400 — Bad request — missing or invalid input
• 401 — Invalid or missing API key
• 402 — Spend cap reached, or free trial exhausted with no card on file
• 502 — Recipe or provider failed

Lot Trace

Aerial photo + boundary points → parcel isolation with an acreage callout. Returns the result synchronously in the response (no polling).

Request body

• image_urlstring · uri — Input image (single-image recipes).
• photosarray — Input photos (Listing Kit, Cinematic Reel).
• detailsobject — Listing details (Listing Kit, Cinematic Reel).
• pointsarray — Boundary points in image pixels (Lot Trace).
• notesstring — Extra edit guidance, where the recipe accepts it.

Responses

• 200 — Result returned synchronously
• 400 — Bad request — missing or invalid input
• 401 — Invalid or missing API key
• 402 — Spend cap reached, or free trial exhausted with no card on file
• 502 — Recipe or provider failed

Cinematic Reel

Listing photos (up to 3 stills) → a post-ready cinematic reel with captions. Returns a reel_id and a poll_url — poll that path (/v1/recipes/reel/{reel_id}), not /v1/tasks.

Request body

• image_urlstring · uri — Input image (single-image recipes).
• photosarray — Input photos (Listing Kit, Cinematic Reel).
• detailsobject — Listing details (Listing Kit, Cinematic Reel).
• pointsarray — Boundary points in image pixels (Lot Trace).
• notesstring — Extra edit guidance, where the recipe accepts it.

Responses

• 202 — Reel queued — poll the returned poll_url
• 400 — Bad request — missing or invalid input
• 401 — Invalid or missing API key
• 402 — Spend cap reached, or free trial exhausted with no card on file
• 502 — Recipe or provider failed

Listing Kit

Listing details + photos → flyer, social, story, captions — brand-locked. Returns the result synchronously in the response (no polling).

Request body

• image_urlstring · uri — Input image (single-image recipes).
• photosarray — Input photos (Listing Kit, Cinematic Reel).
• detailsobject — Listing details (Listing Kit, Cinematic Reel).
• pointsarray — Boundary points in image pixels (Lot Trace).
• notesstring — Extra edit guidance, where the recipe accepts it.

Responses

• 200 — Result returned synchronously
• 400 — Bad request — missing or invalid input
• 401 — Invalid or missing API key
• 402 — Spend cap reached, or free trial exhausted with no card on file
• 502 — Recipe or provider failed