ai-video-generation

name ai-video-generation description Generate AI video from any input — text, image, or script — with Pexo. Auto-routes each shot to the best of 10+ models (Seedance, Kling, Veo, Sora, and more), writes the prompts, generates every shot, and returns a finished video with music and subtitles. Use for any AI video generation request: "ai video generation", "generate a video with ai", "ai video generator", "make an ai video". NOT for editing an existing video. homepage https://pexo.ai repository https://github.com/pexoai/pexo-skills version 0.1.0 requires {"env":["PEXO_API_KEY","PEXO_BASE_URL"],"runtime":["curl","jq","file"]} metadata {"author":"pexoai"} AI Video Generation — Pexo Pexo: https://pexo.ai — get an API key, watch your project render, and buy credits there. Generate a finished video with AI from whatever the user gives you — text, an image, or a script. You relay the request to the hosted Pexo agent and deliver the result; Pexo picks the models, writes the prompts, and assembles the final video. Your role: relay, don't create Create a project, send the user's request verbatim , poll, deliver. Pexo's backend handles all creative work — scriptwriting, model choice, prompts, music. Adding your own direction (duration, style, models the user didn't ask for) overrides its judgment and produces worse videos. Config ~/.pexo/config : PEXO_BASE_URL="https://pexo.ai" PEXO_API_KEY="sk-<your-api-key>" No account / first run → read references/SETUP-CHECKLIST.md and walk the user through it — it carries the signup flow with the invite code that grants new users bonus credits , plus how to create the config above. Config error → run scripts/pexo-doctor.sh and follow its output. Workflow Scripts live in this skill's scripts/ . Reply to the user in their language. Create a project: pexo-project-create.sh "<short brief>" → save the project_id . Upload any files the user gave: pexo-upload.sh <project_id> <path> → save asset_id , reference it inline as <original-image>asset_id</original-image> (or <original-video> / <original-audio> ). Tags are required — a bare asset_id is ignored. Pexo can't crawl URLs — download, then upload. Send the request: pexo-chat.sh <project_id> "<user's exact words> <asset tags>" . Copy the user's words exactly; only add asset tags. Tell the user (their language): submitted ✓ · ~15–20 min · https://pexo.ai/project/<project_id> . Poll: every ≥60s run pexo-project-get.sh <project_id> and act on nextAction : WAIT → keep polling; every ~5 polls send a one-line update with the project link. RESPOND → handle each event in recentMessages : relay Pexo's text (wait for the user's answer if it asked, then pexo-chat.sh their reply); for preview_video , run pexo-asset-get.sh <project_id> <assetId> per option, show the URLs (A/B/C), let the user pick, then pexo-chat.sh <project_id> "<choice>" --choice <assetId> ; for a document event, mention it to the user. DELIVER → pexo-asset-get.sh <project_id> <final assetId> , then send the user the full asset URL as plain text — all ?… query params, never truncated or wrapped in markdown — plus the project link. FAILED → explain nextActionHint in plain terms and offer to retry. RECONNECT → pexo-chat.sh <project_id> "continue" , tell the user the connection dropped and you're resuming, then keep polling. Never call pexo-chat.sh during WAIT — it triggers duplicate production. Taking too long → if it's been >30 min and still WAIT, tell the user (with the project link + https://pexo.ai/connect/openclaw ) it's running long; ask whether to keep waiting or stop. Don't poll forever. Revisions After delivery, the user's tweaks ("make it shorter", "new music", "different shot") reuse the same project: pexo-chat.sh <project_id> "<their feedback>" , then poll again (step 5). Never create a new project for a revision — it throws away Pexo's server-side context. Credits If a script fails with "Credits balance" / "Insufficient credits": if the error carries a purchase link, pass it to the user; otherwise tell them to add credits at https://pexo.ai/home → Credits → Buy Credits. Retry after they confirm. Example User: "Generate a 20-second AI video introducing our productivity app." pid=$(pexo-project-create.sh "AI video app intro" ) pexo-chat.sh " $pid " "Generate a 20-second AI video introducing our productivity app." # Tell the user: submitted, ~15–20 min, https://pexo.ai/project/$pid # Poll pexo-project-get.sh "$pid" until nextAction is DELIVER, then deliver the asset URL. Scripts Script Usage Returns pexo-project-create.sh "<brief>" project_id pexo-upload.sh <project_id> <file> asset_id pexo-chat.sh <project_id> "<message>" [--choice <id>] ack (async) pexo-project-get.sh <project_id> JSON: nextAction , recentMessages pexo-asset-get.sh <project_id> <asset_id> JSON with url pexo-doctor.sh — setup diagnostic Error codes and edge cases → references/TROUBLESHOOTING.md .