API reference

Base URL: https://app.video-blade.com/api/v1. All endpoints below require your API key unless marked public. Responses are JSON.

Account

GET /me

Your account: id, email, agent mode, chat model, unlimited flag and current balance.

GET /balance

Balance, token price and the category coefficients currently in effect.

Projects

GET /projects

Your projects, newest first.

POST /projects

{"name": "My channel", "description": "Short videos about cooking"}

Creates a project and records the action in the project's activity log with actor agent.

Models

GET /models?category=image public

The model catalog with token prices (already multiplied by the category coefficient) and parameter names. Use it to let the user pick one model per project per category.

Generations stage 1

POST /generations

{"model": "google-nano-banana", "input": {"prompt": "…"}, "callback_url": "https://…"}

Returns {"id": "…", "status": "waiting", "tokens_held": 160}. Poll GET /generations/{id} or receive the callback. Media URLs in the result point to Video Blade storage.

Errors