Docs · v0.1
Introduction
Vivacity is near-real-time video infrastructure for LLMs. It turns a prompt, document, or model answer into a narrated, mathematically exact explainer video you can call from an app or agent.
It is not a slide deck tool. The output is a video URL. Math and science are where precision shows most.
Who it is for
- Researchers who need to visualize a proof or derivation
- Educators preparing concept explanations
- Platforms integrating AI-generated educational content via API
Quick start
During early beta, access is invite-only. Request access from the team, then open the workspace with your beta code.
# conceptual flow
POST /v1/jobs { "prompt": "Explain eigenvectors" }
GET /v1/jobs/:id
→ { "status": "ready", "video_url": "..." }Official SDKs and full auth docs ship with broader beta. Until then, use the workspace UI at /signin.
Pipeline architecture
Four stages run per request:
- Prompt interpretation: extract mathematical intent and map it to a scene plan.
- Code generation: turn the plan into executable motion code, with critique and repair.
- Rendering: exact animation frames for the lesson.
- Audio sync: align narration to animation keyframes.
REST API shape
Authentication will use API keys scoped to a workspace. Jobs are asynchronous. Poll status or subscribe to webhooks when available.
Authentication
Authorization: Bearer viv_live_xxx Content-Type: application/json
Create a job
POST /v1/jobs
{
"prompt": "Explain the chain rule",
"resolution": "1080p"
}
→ { "id": "job_…", "status": "queued" }Poll status
GET /v1/jobs/:id
→ { "status": "ready", "video_url": "https://…" }