API Reference

Create AI avatar videos over one REST API: turn a script (text or audio) into a lip-synced talking avatar, build custom avatars from a photo, clone voices, and generate videos with frontier AI video models.

Base URL

Every endpoint is relative to the base URL. For example, POST /api/v1/video calls https://openapi.visionstory.ai/api/v1/video.

Base URL

https://openapi.visionstory.ai

Authentication

Authenticate every request with an X-API-Key header. Keep the key server-side; never expose it in browser code or a public repository.

Header

X-API-Key: sk-vs-xxxxxxxxxxxxxxxxxxx

Create or manage API keys at https://www.visionstory.ai/openapi (Pro plan or above required).

SDKs & agents

Drive the API from an AI coding agent with the installable skill package — SKILL.md plus a dependency-free Python CLI for creating avatars and videos, discovering resources, polling tasks, and downloading results:

Install

mkdir -p .agents/skills
curl -fsSL https://openapi.visionstory.ai/skills/visionstory-video-api.zip -o visionstory-video-api.zip
unzip -o visionstory-video-api.zip -d .agents/skills
rm visionstory-video-api.zip

Prefer machine-readable docs? Fetch llms.txt, and append .md to any documentation page URL to get its Markdown variant.

Start here

Pick a resource from the left to see its parameters, response schema, and ready-to-run code samples in nine languages. Start with the first endpoint.