Task Results

# Task Results

Use this skill when the user already has a Freebeat task id or Open RPC batch id and needs status, waiting, or result URLs.

## Before running CLI commands

Freebeat CLI is an npm package and authenticated API client. Install or refresh it first:

~~~bash
npm install -g freebeat-cli@latest
freebeat --help
~~~

The user must provide a Freebeat API key before generation. Use one of these patterns:

~~~bash
freebeat auth set-api-key
printf '%s' "$FREEBEAT_API_KEY" | freebeat auth set-api-key --stdin
freebeat --api-key <apiKey> <command>
~~~

Validate credentials before starting a paid or long-running workflow:

~~~bash
freebeat auth show
freebeat auth test
~~~

Do not paste or log the raw API key. Ask the user to provide it in their terminal, secret store, or environment variable.

## Legacy MV and effect tasks

~~~bash
freebeat task status <task-id>
freebeat task wait <task-id>
freebeat task result <task-id>
~~~

## Open RPC image and video batches

~~~bash
freebeat task status <batch-id>
freebeat task status <batch-id> --serial-no <serial-no>
freebeat task wait <batch-id> --serial-no <serial-no>
~~~

## JSON output

~~~bash
freebeat task status <batch-id> --serial-no <serial-no> --json
freebeat task result <task-id> --json
~~~

## Wait behavior

The default poll interval is 15s and the default timeout is 2h. Override them for longer queues or faster local checks:

~~~bash
freebeat task wait <task-id> --poll-interval 30s --timeout 3h
~~~

Expected result: the CLI returns status fields while the job is running, then completed video_url, cover_url, or Open RPC result URLs when the job finishes.