Connect an agent

Create a key, point your agent at Sundream, and make your first film from the command line.

1. Create a key

In Settings → API keys, create one. Name it after whatever will use it — the name is how you'll recognise it later when deciding what to revoke.

You'll choose two things:

Render approval. Start with Confirm each render. Renders will be quoted and wait for your agent to approve them, so nothing spends credits while you're still finding your footing.
Spend cap. Optional, in credits, over a rolling 24 hours. Worth setting even on a confirming key.

The key is shown once. Copy it then — it can't be retrieved afterwards, only replaced.

Keys belong to a workspace and spend that workspace's credits, so creating one requires an admin or owner role.

2. Point your agent at it

For Claude Code:

claude mcp add sundream -- npx -y @zeta-studio/mcp --key zsk_... --media-dir ./assets

Other MCP clients take the same command in whatever form they configure servers. The flags:

Flag	Meaning
`--key`	Your API key. Or set `ZETA_API_KEY`.
`--media-dir`	Mirror finished renders into this folder. Omit to keep media hosted.

To connect a hosted agent instead, point it at the remote endpoint shown on the API keys page and send your key as a bearer token.

3. Make something

Your agent now has the studio's tools. The fastest start is the guided intake, which most clients surface as a slash command:

/new-film

It asks what kind of video you want, the tone, roughly how long, and whether you'd like to see a scene-by-scene outline before anything gets built. Then it recommends an image and video model for that specific film, with what each costs.

You can also just say what you want — "make me a 20-second vertical ad for cold brew, handheld, slightly grainy" — and the agent will work from there.

4. Get the footage

Renders run in the background. Ask your agent how they're going and it will check; when they're done, syncProjectMedia pulls everything into your media folder:

assets/
  clips/01-hook.mp4
  frames/01-hook.jpg
  characters/nova.jpg
  my-film-script.txt

The layout matches a project export, so a mirrored folder and a downloaded archive are interchangeable. Re-running it only fetches what's new.

If your agent seems lost

Ask it to call whatsNext. It reports where the project stands — what's mid-render, what's blocked, and which actions are available right now — which is faster than having it work that out from the board.