Generate video
Create AI-generated videos for demos, marketing, tutorials, and screenshot animations. Videos are uploaded to cloud storage and returned as public URLs.
This endpoint requires session-based authentication. You must be signed in with a valid user account. All requests must include the Content-Type: application/json header.
Video generation can take up to 5 minutes per request (maxDuration: 300). Plan for long response times when integrating this endpoint.
Create a video
Generate a video based on the specified type and parameters.
Request body
| Field | Type | Required | Description |
|---|
type | string | Yes | Video type. One of demo, marketing, screenshot, or tutorial. |
agentName | string | When type is demo | Name of the agent to feature in the demo video |
agentDescription | string | When type is demo | Description of the agent’s capabilities |
productName | string | When type is marketing | Name of the product to promote |
features | array | When type is marketing | List of product features to highlight |
imageUrl | string | When type is screenshot | URL of the screenshot image to animate |
description | string | When type is screenshot | Description of the animation to apply |
topic | string | When type is tutorial | Tutorial topic |
steps | array | When type is tutorial | Ordered list of tutorial steps |
Example requests
Demo video
{
"type": "demo",
"agentName": "SupportBot",
"agentDescription": "An AI agent that handles customer support tickets"
}
Marketing video
{
"type": "marketing",
"productName": "Agentbot",
"features": ["AI-powered agents", "Multi-channel support", "Onchain payments"]
}
Screenshot animation
{
"type": "screenshot",
"imageUrl": "https://example.com/dashboard.png",
"description": "Zoom into the analytics panel and highlight key metrics"
}
Tutorial video
{
"type": "tutorial",
"topic": "Setting up your first agent",
"steps": ["Create an account", "Configure your agent", "Connect a channel", "Go live"]
}
Response
Returns the public URL of the generated video:
{
"url": "https://public.blob.vercel-storage.com/videos/1712345678901.mp4"
}
Errors
| Code | Description |
|---|
| 400 | Invalid video type. Must be demo, marketing, screenshot, or tutorial. |
| 401 | Unauthorized — you must be signed in |
| 500 | Video generation or upload failed |
Error response
{
"error": "Invalid video type"
}
