Documentation Index
Fetch the complete documentation index at: https://docs.vidjutsu.ai/llms.txt
Use this file to discover all available pages before exploring further.
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"
~/.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_...
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"
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>" }'
curl -X POST https://api.vidjutsu.ai/v1/auth/verify/confirm \
-H "Content-Type: application/json" \
-d '{ "email": "<your_email>", "code": "847291" }'
