xBookvideo API

Book-to-Video SaaS API — Upload books, auto-generate episode plans, AI creates short videos.

Base URL: https://xbookvideo.com Version: 1.0.0

Authentication

# Method A: X-API-Key header
curl -H "X-API-Key: xbk_your_api_key_here" \
  https://xbookvideo.com/api/v1/auth/me

# Method B: Authorization Bearer
curl -H "Authorization: Bearer xbk_your_api_key_here" \
  https://xbookvideo.com/api/v1/auth/me

curl -H "Authorization: Bearer " \
  https://xbookvideo.com/api/v1/auth/me

Rate Limits

Rate limit response includes these headers:

X-RateLimit-Limit: 10
X-RateLimit-Remaining: 7
X-RateLimit-Reset: 1721820000

When exceeded, returns 429 Too Many Requests.

API Endpoints

Authentication & API Keys

Book Upload & Writing

Episode Planning & Rendering

Videos & Downloads

Payment

Sharing & Compression

Knowledge Index & Search

Google Books & Public Domain

Code Examples

Python

import httpx

API_KEY = "xbk_your_api_key_here"
BASE_URL = "https://xbookvideo.com"

# 1. Upload book
with open("book.pdf", "rb") as f:
    resp = httpx.post(
        f"{BASE_URL}/api/v1/upload",
        headers={"X-API-Key": API_KEY},
        files={"file": ("book.pdf", f, "application/pdf")},
    )
    project_id = resp.json()["project_id"]

# 2. Generate episode plan
httpx.post(
    f"{BASE_URL}/api/v1/plan",
    headers={"X-API-Key": API_KEY, "Content-Type": "application/json"},
    json={"project_id": project_id, "total_episodes": 12},
)

# 3. Poll plan progress
import time
while True:
    status = httpx.get(
        f"{BASE_URL}/api/v1/projects/{project_id}/status",
        headers={"X-API-Key": API_KEY},
    ).json()
    if status["status"] in ("planned", "demo_ready", "completed"):
        break
    time.sleep(5)

# 4. Generate demo
httpx.post(
    f"{BASE_URL}/api/v1/generate-demo",
    headers={"X-API-Key": API_KEY, "Content-Type": "application/json"},
    json={"project_id": project_id, "episode_indices": [0, 1]},
)

# 5. Get video list
videos = httpx.get(
    f"{BASE_URL}/api/v1/projects/{project_id}/videos",
    headers={"X-API-Key": API_KEY},
).json()
for v in videos["videos"]:
    print(f"Episode {v['episode']}: {v['title']} ({v['duration']:.0f}s)")

cURL — Create API Key

# First login with JWT to get token
TOKEN=$(curl -s -X POST https://xbookvideo.com/api/v1/auth/login \
  -H "Content-Type: application/json" \
  -d '{"username":"your_username","password":"your_password"}' \
  | python3 -c "import sys,json; print(json.load(sys.stdin)['token'])")

# Create API Key
curl -X POST https://xbookvideo.com/api/v1/api-keys \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"My Production Key","scopes":"read,write,render"}'

# List API Keys
curl https://xbookvideo.com/api/v1/api-keys \
  -H "Authorization: Bearer $TOKEN"

JavaScript (Node.js)

const API_KEY = "xbk_your_api_key_here";
const BASE = "https://xbookvideo.com";

// Upload book
const formData = new FormData();
formData.append("file", fs.createReadStream("book.pdf"));

const uploadRes = await fetch(`${BASE}/api/v1/upload`, {
    method: "POST",
    headers: { "X-API-Key": API_KEY },
    body: formData,
});
const { project_id } = await uploadRes.json();

// Generate episode plan
await fetch(`${BASE}/api/v1/plan`, {
    method: "POST",
    headers: {
        "X-API-Key": API_KEY,
        "Content-Type": "application/json",
    },
    body: JSON.stringify({ project_id, total_episodes: 12 }),
});

// Query progress
const status = await fetch(
    `${BASE}/api/v1/projects/${project_id}/status`,
    { headers: { "X-API-Key": API_KEY } }
).then(r => r.json());
console.log("Status:", status.status, "Progress:", status.progress);

Error Codes

xBookvideo API · ← Back to App