Authentication

Need to get your first API key? See Get your API key.

Using your key

Pass your API key as a Bearer token in the Authorization header on every request:

curl https://api.vidjutsu.ai/v1/usage \
  -H "Authorization: Bearer $VIDJUTSU_API_KEY"

If you’re using the CLI, your key is stored in ~/.vidjutsu/config.json and sent automatically.

Storing your key safely

Your key is a secret. Treat it like a password.

Do	Don’t
Store in environment variables	Commit to git
Use `.env` files (add to `.gitignore`)	Share in Slack/email
Use your platform’s secrets manager (Vercel, AWS, etc.)	Hardcode in source files

# .env
VIDJUTSU_API_KEY=vj_live_...

For a portable credentials file:

vidjutsu auth --export
# Writes ~/.vidjutsu/credentials.json

Rotating your key

If your key is compromised, rotate it immediately. The old key is invalidated instantly.

curl -X POST https://api.vidjutsu.ai/v1/api_keys/rotate \
  -H "Authorization: Bearer $VIDJUTSU_API_KEY"

The response contains your new key. Store it securely — the old one no longer works.

Recovering a lost key

If you lost your key, recover it via email verification:

vidjutsu auth --recover <your_email>
# Check your email for a 6-digit code

vidjutsu auth --verify --email <your_email> --code 847291

Request a verification code:

curl -X POST https://api.vidjutsu.ai/v1/auth/verify/request \
  -H "Content-Type: application/json" \
  -d '{ "email": "<your_email>" }'

Confirm the code to get your key back:

curl -X POST https://api.vidjutsu.ai/v1/auth/verify/confirm \
  -H "Content-Type: application/json" \
  -d '{ "email": "<your_email>", "code": "847291" }'

Getting Started

Reference

Recipes

Legal

Using your key

Storing your key safely

Rotating your key

Recovering a lost key

​Using your key

​Storing your key safely

​Rotating your key

​Recovering a lost key

Using your key

Storing your key safely

Rotating your key

Recovering a lost key