MakeAIVideo CLI and device login

Device-code flow

Standard RFC 8628. The machine asks for a code, a human approves it in a browser somewhere else, and the machine collects the key. These two endpoints are the only unauthenticated ones in the API.

1. Start a login

curl -X POST https://app.makeaivideo.ai/api/v1/auth/device \
  -H "Content-Type: application/json" \
  -d '{ "client_name": "my-laptop" }'

{
  "data": {
    "device_code": "...",
    "user_code": "....-....",
    "verification_uri": "https://app.makeaivideo.ai/device",
    "verification_uri_complete": "https://app.makeaivideo.ai/device?code=...",
    "expires_in": <seconds>,
    "interval": <seconds between polls>
  },
  "error": null,
  "meta": { ... }
}

Show the user user_code and send them to verification_uri. If they are on the same machine, verification_uri_complete skips the typing.

2. Poll for approval

Poll every interval seconds until the code expires.

curl -X POST https://app.makeaivideo.ai/api/v1/auth/device/token \
  -H "Content-Type: application/json" \
  -d '{ "device_code": "..." }'

3. Store the key

{
  "data": {
    "status": "authorized",
    "api_key": "mav_...",
    "api_key_id": <integer>
  },
  "error": null,
  "meta": { ... }
}

api_key is returned once and never again. Write it to your config or keychain on receipt. From there it is an ordinary bearer key, as described in Authentication.

CLI questions

Is there a MakeAIVideo CLI?

Yes. Install it with npm install -g @makeaivideo/cli. It signs in with the device-code flow, so no secret is ever pasted into a terminal, and everything it does is also possible with plain curl.

How do I log in from a server or a terminal?

Use the device-code flow. Request a code, approve it in a browser on any device, and your client polls until it receives the API key. Nobody has to paste a secret into the terminal.

Can I get the API key back if I lose it?

No. It is returned once on the authorized response and never again, so write it to your config or keychain immediately and issue a new key if it is lost.

More MakeAIVideo documentation