API Reference

Vydra API

Bot-native video generation API. Register in 30 seconds, generate in 60.

BASE URLhttps://vydra.ai/api/v1

Bot Registration

No human account needed. Bots register themselves.

POST /api/v1/auth/bot-register Content-Type: application/json {"bot_name": "my-agent"} → { "api_key": "vyd_...", "dashboard_token": "dt_..." }

Models

Model	Type	Credits	Speed
veo3	Video	175	~60s
kling-3.1	Video	300	~90s
seedance	Video	150	~60s
grok-imagine	Image/Video	8 / 150	~5s
gemini	Image	5	~3s
flux-edit	Image Edit	5	~5s
elevenlabs	Voice	5	~3s

Create Job

POST /api/v1/jobs Authorization: Bearer {api_key} { "workflow": "generate_video", "input": { "prompt": "Aerial drone shot of Manhattan at golden hour", "model": "veo3" }, "webhookUrl": "https://your-agent.com/webhook" // optional } → {"id": "abc-123", "status": "running", "workflow": "generate_video", "creditsCharged": 175}

Job Status

GET /api/v1/jobs/{id} Authorization: Bearer {api_key} → { "jobId": "abc-123", "status": "completed", // pending | running | completed | failed | cancelled "result": { "videoUrl": "https://pub-xxx.r2.dev/video/..." }, "creditsCharged": 175, "completedAt": "2026-03-18T16:00:00Z" }

MCP Configuration

Works with Claude Desktop, Cursor, and any MCP-compatible agent. OpenClaw users can also use Vydra through the bundled media provider.

{ "mcpServers": { "vydra": { "command": "npx", "args": ["-y", "vydra-mcp"], "env": { "VYDRA_API_KEY": "vyd_your_key_here" } } } }

Code Examples

# Register bot
curl -X POST https://vydra.ai/api/v1/auth/bot-register \
  -H "Content-Type: application/json" \
  -d '{"bot_name": "my-agent"}'

# Create a generation job
curl -X POST https://vydra.ai/api/v1/jobs \
  -H "Authorization: Bearer $VYDRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"workflow": "generate_video", "input": {"prompt": "...", "model": "veo3"}}'

# Check job status
curl https://vydra.ai/api/v1/jobs/$JOB_ID \
  -H "Authorization: Bearer $VYDRA_API_KEY"

Canonical Workflows

Workflow	Description	Credits
generate_video	Text/image → video	150–300
generate_image	Text → image	5–8
edit_image	Edit existing image	5
lipsync_video	Face + audio → talking head	100
swap_character	Swap face/character	50
transfer_motion	Apply motion to image	200
generate_asmr	Themed ASMR video	175