The API is plain REST with an OpenAPI 3 schema at api.craftstory.com/api/v1/docs/public/swagger.json — generate a typed client for any language, or point an AI coding agent at the schema and the curl walkthrough.

CraftStory API

Generate hyper-realistic AI avatar videos programmatically. One photo or a custom avatar plus a script or audio — the REST API returns a finished talking video with natural lip-sync and gestures, up to 5 minutes long, in 30+ languages. Built by the team behind OpenCV.

Plain REST + OpenAPI schema — works with any language and any AI coding agent

Read the API docs Get your API key

What you can build

UGC ads at scale — generate dozens of hook variants with the same presenter for TikTok, Reels and YouTube Shorts, straight from your ad pipeline.
Personalized video outreach — render a talking video per lead or per customer from a template script.
Products and agents that speak — give your app, workflow or AI agent the ability to produce talking-head video: the API is self-describing via OpenAPI, so coding agents integrate it in minutes.
Custom avatars and voices — list and use LoRA avatars trained from ~15 seconds of video, and voices cloned in the app.

Quickstart

Authentication is a Bearer API key (sk-cs-...), created in the app under Profile → API. Base URL: https://api.craftstory.com/api/v1/

# 1. List avatars (yours + library) curl -H "Authorization: Bearer $CRAFTSTORY_API_KEY" \ https://api.craftstory.com/api/v1/image2video/avatars/ # 2. Start a video generation curl -X POST -H "Authorization: Bearer $CRAFTSTORY_API_KEY" \ -H "Content-Type: application/json" \ -d '{"text": "Hello from the CraftStory API!", "voice_id": "...", "lora_avatar_id": "..."}' \ https://api.craftstory.com/api/v1/image2video/ # 3. Poll status and download the MP4 curl -H "Authorization: Bearer $CRAFTSTORY_API_KEY" \ https://api.craftstory.com/api/v1/image2video/{id}/

Full request/response shapes for every endpoint: step-by-step curl walkthrough · API reference (ReDoc) · OpenAPI schema

Why CraftStory instead of a generic video API

Most video-generation APIs cap talking-head clips at 30–60 seconds and lose the face over time. CraftStory keeps the same identity across the whole video — up to 5 minutes — and supports custom avatars of real people (with consent) trained from a short phone video. Pricing is credit-based on your existing plan; there is no separate API contract, and a free plan to try.

FAQ

Frequently asked questions

How do I get a CraftStory API key?

API access is included in paid CraftStory plans. Sign in to app.craftstory.com, open Profile → API and create a key (format sk-cs-...). Use it as a Bearer token in the Authorization header.

What can the CraftStory API do?

Everything the app does: turn a photo or an AI actor into a hyper-realistic talking video from a script or audio (up to 5 minutes), list and use your custom LoRA avatars and cloned voices, poll job status and download finished MP4s.

Is there an SDK?

The API is plain REST with an OpenAPI 3 schema — generate a typed client for any language, or point an AI coding agent at the schema and the curl walkthrough.

Does API usage cost extra?

No separate API pricing: API-generated videos use the same credits as videos made in the app, on your existing subscription.