Skip to main content
POST
Start a generation
The generation starts asynchronously and returns a generationId immediately. Poll Get a generation until its status is completed, then read outputs[0].url. By default the generation is billed to the key’s own wallet — for account-bound keys, your account wallet. Pass workspace_id (see List workspaces) to act in and bill another workspace you can manage.

Authorizations

Authorization
string
header
required

A workspace API key. Secret keys (flowy_…) are server-side — keep them private. Publishable keys (flowy_pk_…) are browser-safe but only work from their allowlisted domains.

Body

application/json
workspace_id
string

Optionally bill a different workspace the account can manage; default is the key's own wallet.

mode
enum<string>

Audio only; default sfx

Available options:
sfx,
music
geometry_format
enum<string>

3d only; default glb

Available options:
glb,
usdz,
fbx,
obj,
stl
material
enum<string>

3d only; default All

Available options:
All,
PBR,
Shaded

Response

Generation accepted. Poll GET /v1/generations/{generationId}.

data
object