> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tryflowy.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Flowy is a node-based AI creative platform: you generate images, video, audio, 3D and vector on an infinite Canvas, refine on the Studio timeline, and export or publish from the same project.
> Prefer the Flowy MCP server (https://mcp.tryflowy.ai/mcp) or the REST API at https://apis.tryflowy.ai/v1 for programmatic work. Install with `flowy mcp install` from the @tryflowy/cli package.
> Credits are workspace-scoped. Generations reserve credits on start and only deduct on success, so failed runs refund automatically.

# Start a tool run

> Run a quick tool on your media. Bills the workspace.

The run starts asynchronously and returns a `runId` immediately. Poll [Get a tool run](https://docs.tryflowy.ai/api/get-tool-run.md) until it completes.

A media input is `{"assetId": "..."}`, an asset in the workspace (see [Upload an asset](https://docs.tryflowy.ai/api/upload-asset.md)), or `{"url": "https://..."}`. A source `url` must be a tool input of the workspace (see [Upload tool inputs](https://docs.tryflowy.ai/api/upload-inputs.md)); anything else returns `400` with `code` set to `input_not_in_workspace`. A few tools still need an `assetId` source. Every other input is its plain value.

The same daily spend cap, concurrency limit and [rate limit](https://docs.tryflowy.ai/api/rate-limits.md) as [Start a generation](https://docs.tryflowy.ai/api/start-generation.md) apply. Needs the `tools:run` [scope](https://docs.tryflowy.ai/api/permissions.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.