Search VisionStory documentation

No documentation matched “”.

Try a feature or resource name such as , , or .

VisionStoryDevelopers
Get API key
VisionStory AI video API

From script to speaking video, in one request.

Build talking-avatar video workflows without maintaining a media pipeline. Call the VisionStory REST API directly, use the Python SDK or CLI, or give the complete generation flow to an AI agent.

Create your first video Explore the API
Input
Text or audio
Output
MP4 video
Interfaces
API · SDK · CLI · MCP
POST/api/v1/video
from visionstory import VisionStoryClient, build_video_payload

client = VisionStoryClient.from_env()
video = client.generate_video(build_video_payload(
    avatar_id="your_avatar_id",
    text="Welcome to VisionStory.",
    voice_id="your_voice_id",
))
client.download(video["video_url"], "result.mp4")
✓Requestaccepted
✓Rendercompleted
▶result.mp4ready

Start with your workflow

Choose by what you want to do.

Building an application? Start with the Python SDK. Working in a terminal or CI job? Use the CLI. Want an AI agent to handle the workflow? Choose MCP or the Agent Skill.

sdk

Build in Python

Best for applications

Typed helpers for authentication, uploads, polling, and downloads with no runtime dependencies.

pip install visionstoryOpen guide
cli

Automate from the shell

Best for terminal & CI

Create videos, inspect tasks, and download results from scripts or CI without writing an app.

curl -fsSL https://developers.visionstory.ai/cli | bashOpen guide
mcp

Give tools to agents

Best for AI agents

Connect VisionStory through MCP or install the Skill so coding agents can generate media for you.

uvx visionstory-mcpOpen guide

Agent ready

Works where your agents work.

Copy one setup message for your coding agent, or connect the MCP server and expose VisionStory as a reusable tool.

VisionStory CLI

Install once. Use every API from your terminal.

The installer upgrades to the latest PyPI release in an isolated environment. Your existing Python projects stay untouched.

curl -fsSL https://developers.visionstory.ai/cli | bash
macOS · Linux · WSLInstallation options
Send this to Claude Code
Help me set up VisionStory and generate a talking-avatar video.1. Install or update the CLI and Agent Skill:   curl -fsSL https://developers.visionstory.ai/cli | bash   npx skills add visionstory-ai/skills --skill visionstory-api2. Run visionstory doctor. If I need a key, send me to https://developers.visionstory.ai/api-keys, wait while I create one, then ask me to run visionstory login in my terminal. Never ask me to paste the key into chat or expose it.3. Verify access with visionstory credits. Stop and help me if it fails.4. Discover current models, avatars, and voices, then use the CLI and visionstory-api skill to create and download the video. Never delete anything unless I explicitly request and confirm it.

New here? Create an API key, then send this prompt to Claude Code. It will guide you through visionstory login, verify credits, and create the video without exposing your key.

One complete workflow

From avatar to video in four steps

Choose an avatar, add text or audio, and let VisionStory render your talking-avatar video.

  1. 01

    Choose an avatar

    Use a public avatar or create one from a portrait.

  2. 02

    Add text or audio

    Write a script and choose a voice, or use recorded audio.

  3. 03

    Generate

    Submit once; VisionStory renders asynchronously.

  4. 04

    Download

    When the task succeeds, download the MP4 from the returned URL.

API capabilities

Everything behind the request.

Start with talking avatars, then reach for voices, image generation, frontier video models, and reusable media assets as your workflow grows.

1 endpoint

Media Understanding

Extract structured data from images, audio, or video using your JSON Schema.

Open guide
3 endpoints

Avatars

List public AI avatars or create a reusable custom avatar from one portrait.

Open guide
3 endpoints

Voices

List public voices or clone a custom AI voice from an audio sample.

Open guide
1 endpoint

Models

Discover supported talking-avatar models, resolutions, and aspect ratios.

View reference
1 endpoint

Billing

Read the current subscription plan and remaining generation credits.

View reference
6 endpoints

AI Video

Generate text-to-video, image-to-video, and reference-guided AI clips.

Open guide
1 endpoint

Text to Speech

Convert text into natural MP3 speech with any public or cloned voice.

Open guide
2 endpoints

Speech to Text

Transcribe speech, identify speaker turns, export SRT subtitles, or align known text to audio.

Open guide
2 endpoints

Image Generation

Generate or edit AI images from text prompts and optional reference media.

Open guide
3 endpoints

Assets

Upload and reuse images, audio, and video across generation requests.

View reference
Need the machine-readable surface?Browse every endpoint

Your first successful call

Make the first request.

Start with an API key, run the ready-made example, and use the returned video_id to follow your render.

Open quickstart Get API key
Request path Ready to run
  1. 1
    AuthenticateVISIONSTORY_API_KEY
  2. 2
    Send the request

    POST/api/v1/video

  3. ✓
    Receive a task IDvideo_123456
200 successJSON response
{
  "data": {
    "video_id": "video_123456"
  },
  "message": "success",
  "server_time": "2026-08-24T08:00:00Z"
}