Create your API key
1
Go to the dashboard
Navigate to Workspace → Your Account → API Keys.
Signed in, the link goes straight to your keys; signed out, it takes you
through sign-in and lands you there.
2
Create a key
Click Add key, give it a name you’ll recognise later, and pick its
scopes.
3
Copy your key
Copy the key immediately. It is shown exactly once: only its hash is
stored, so nobody can retrieve it again, not you, not support. Lose it →
revoke it and create another.
Set your API key
Keys look likeake_live_…. Set yours as an environment variable:
- macOS/Linux
- Windows (PowerShell)
- .env file
Authorization header:
Key scopes
When creating a key you choose its scopes: they’re frozen into the key, and every endpoint requires one. A key without the needed scope gets the typedSCOPE_DENIED blocker at estimate time, before any spend. Scopes only ever
carve down from what your account can already do.
Not sure what to pick? The two presets in the dialog cover most keys:
Read only (safe for dashboards and monitoring) and For skills
(
recipes:read, jobs:read, material:write, render:submit: what an
agent needs to make videos end to end). You can always create another key
with more scope later.Some scopes deliberately do not exist yet: there is no
canvas:write, no
social:publish, and no billing:*. A key can never edit your canvases
behind your back, post to your social accounts, or touch billing. Those
capabilities are withheld from the scope vocabulary itself, so no
combination of checkboxes can grant them.Test your key
Verify it works with the identity call: it needs onlyrecipes:read and
costs nothing.