Hotel Room Tour
Swaps bedding, lamps, and accent colors across multiple hotel room walkthrough angles.
6 images → 11 videos · ~28 min · 0 runs
API
Swaps bedding, lamps, and accent colors across multiple hotel room walkthrough angles.
FLOWY_API_KEY.Create key 1. Calling the API
Base URL & auth#
The API is plain REST. No client library required. Every request is authenticated with a bearer token and points at a single base URL:
Submit a request#
Start a run by POSTing the inputs to the flow's /runs endpoint. The response returns a runId you poll for the result.
2. Authentication
API Key#
Pass your key in the Authorization header as a bearer token on every request. Keep it server-side, never ship it to a browser or mobile client.
3. Queue
Runs are asynchronous: submitting enqueues the run and returns immediately; you poll the queue until it settles, then read the result.
Submit a request#
Alongside inputs, this flow exposes 11 settings you can override in params, the advanced options from the Run tab. The example below sends each at its published default; omit any key to use that default. See Schema for the allowed values of each.
Fetch request status#
Poll /runs/{runId} until status is completed or failed (from queued / running).
Get the result#
Once completed, the result slots are the nodeResults entries flagged isOutput. Each carries a url (media) or text.
4. Files
Hosted files (URL)#
Media inputs are passed by URL. Set asset_url to any publicly reachable image/video/audio link. Host the file yourself (S3, a CDN, etc.) or reuse a URL Flowy already returned from a previous run; there's no separate upload step for the API.
5. Schema
Input#
Each entry in inputs has a node_id (the input's API id, below) plus its value asset_url (a media URL) for media inputs, or prompt for text inputs. A variable input appears ONCE, with its value as a JSON array of min–max entries.
standard-room-referenceStandard room photorequiredbedding-referenceBedding referencerequiredlamp-referenceLamp referencerequiredaccent-color-and-pattern-referenceAccent pattern swatchrequireddeluxe-room-referenceDeluxe room photorequiredsuite-referenceSuite photorequiredParams
Optional. Each key in params is one of the names below; omitting a key uses its default.
standard-room-walkthrough-resolutionStandard room tour resolution480p, 720p, 1080p, 4k · default 720pstandard-room-bedding-swapped-resolutionBedding restyle clip resolution480p, 720p, 1080p, 4k · default 720pstandard-room-lamp-swap-resolutionLamp restyle clip resolution480p, 720p, 1080p, 4k · default 720pstandard-room-accent-swap-resolutionAccent restyle clip resolution480p, 720p, 1080p, 4k · default 720pdeluxe-room-walkthrough-resolutionDeluxe room tour resolution480p, 720p, 1080p, 4k · default 720pdeluxe-room-bedding-swap-resolutionDeluxe bedding clip resolution480p, 720p, 1080p, 4k · default 720pdeluxe-room-lamp-swap-resolutionDeluxe lamp clip resolution480p, 720p, 1080p, 4k · default 720pdeluxe-room-accent-swap-resolutionDeluxe accent clip resolution480p, 720p, 1080p, 4k · default 720psuite-walkthrough-resolutionSuite tour resolution480p, 720p, 1080p, 4k · default 720psuite-lamp-swap-resolutionSuite lamp clip resolution480p, 720p, 1080p, 4k · default 720psuite-accent-swap-resolutionSuite accent clip resolution480p, 720p, 1080p, 4k · default 720pOutput#
The result is an array of output records. Each has a name (the output title), a kind, and the produced url or text.
standard-room-walkthroughStandard room tourstandard-room-bedding-swappedBedding restyle clipstandard-room-lamp-swapLamp restyle clipstandard-room-accent-swapAccent restyle clipdeluxe-room-walkthroughDeluxe room tourdeluxe-room-bedding-swapDeluxe bedding clipdeluxe-room-lamp-swapDeluxe lamp clipdeluxe-room-accent-swapDeluxe accent clipsuite-walkthroughSuite toursuite-lamp-swapSuite lamp clipsuite-accent-swapSuite accent clipOther#
A run record also carries runId, status (queued → running → completed | failed), an error string when it fails, and nodeResults (every executed node's verdict; the isOutput ones are the results above).