Generate branded AI avatar lip-sync video shorts for TikTok, Reels, and YouTube Shorts. Create 15-second talking-head videos with custom avatars, auto-generated scripts, and burned-in subtitles for $1.85.
Generate branded AI avatar lip-sync video shorts for TikTok, Reels, and YouTube Shorts. Create 15-second talking-head videos with custom avatars, auto-generated scripts, and burned-in subtitles for $1.85.
API keys (prefixed citedy_agent_) are stored in the user's local agent
configuration. Keys authenticate only against Citedy API endpoints
(www.citedy.com/api/agent/*). All traffic is TLS-encrypted.
AI Video Shorts — Skill Instructions
You are now connected to Citedy — an AI platform for SEO content automation and video short generation. Base URL: https://www.citedy.com
Overview
This skill lets you generate branded AI avatar lip-sync video shorts optimized for TikTok, Instagram Reels, and YouTube Shorts — directly from a topic or product description. A complete 15-second talking-head video with a custom avatar, AI-generated speech script, and burned-in subtitles costs approximately $1.85 (185 credits). No other MCP skill or agent tool currently offers branded UGC viral video generation with full pipeline control: script → avatar → video → merge with subtitles.
When to Use
Activate this skill when the user says something like:
"Create a TikTok video about [topic/product]"
"Make a short video for Instagram Reels"
"Generate an AI UGC viral video for YouTube Shorts"
"I need a 15-second promo video"
"Make a talking-head video about [subject]"
"Create video content for social media"
"Generate a short clip with subtitles"
"Make a video ad for my product"
"I want a video shorts series about [topic]"
Instructions
Setup (run once)
If you don't have a saved API key for Citedy, run this flow:
1. Register
Preferred: run the included registration script:
node scripts/register.mjs [agent_name]
The script calls the registration API and prints the approval URL. If agent_name is omitted, it defaults to agent-<hostname>.
Alternative: call the API directly:
POST https://www.citedy.com/api/agent/register
Content-Type: application/json
{"agent_name": "<your_agent_name>"}
POST https://www.citedy.com/api/agent/shorts — 60–185 credits, async
Submit the video generation job. Poll for completion.
{"prompt":"Professional woman in modern office. Camera: medium close-up, steady. Style: clean corporate. Motion: subtle head nods while speaking. Audio: no background music.","avatar_url":"https://download.citedy.com/avatars/...","duration":10,"resolution":"720p","aspect_ratio":"9:16","speech_text":"Here is exactly what the avatar says in quotes."}
Returns when done: { "status": "completed", "video_url": "https://download.citedy.com/shorts/..." }
Step 4 — Merge Segments and Add Subtitles
POST https://www.citedy.com/api/agent/shorts/merge — 5 credits
Combine one or more video segments and burn in subtitles.
{"video_urls":["https://download.citedy.com/shorts/seg1.mp4"],"phrases":[{"text":"Here is exactly what the avatar says in quotes."}],"config":{"words_per_phrase":4,"font_size":48,"text_color":"#FFFFFF"}}
User: Make a 10-second TikTok video promoting my skincare serum
Agent response:
I'll create a 10-second TikTok video for your skincare serum. Here's the plan and cost:
Script generation: 1 credits ($0.01)
Avatar generation: 3 credits ($0.03)
Video generation (10s): 130 credits ($1.30)
Merge + subtitles: 5 credits ($0.05)
Total: 139 credits ($1.39)
Shall I proceed?
(after approval)
Generating script... done.
Script: "Tired of dull skin? Our new Vitamin C Serum delivers visible glow in just 7 days. Click the link to try it risk-free today."
Generating avatar... done.
Generating video (this takes ~60–90 seconds)... polling...
Video ready! Merging with subtitles...
User: Create a YouTube Shorts video explaining what SEO is, for beginners
Agent response:
I'll create a 15-second educational YouTube Short about SEO basics. Estimated cost: 197 credits ($1.97). Proceed?
(after approval)
Script: "SEO stands for Search Engine Optimization. It's how you get your website to show up when people Google something. Better SEO means more visitors — and more customers — for free."
Motion: How the avatar moves (NOT speech — speech goes in speech_text). "Motion: subtle head nods and natural hand gestures."
Audio: Music and sound design. Always specify. "Audio: no background music, clear voice only."
Speech text rules:
Put the exact speech in speech_text, NOT in prompt
speech_text must match the script output verbatim
Keep speech under 150 words for a 15s segment
Do NOT blend description and speech in the same field
Full example prompt:
Professional man in a tech startup office with a city view behind him.
Camera: medium close-up, steady, slight bokeh on background.
Style: modern casual, warm lighting, dark branded t-shirt.
Motion: natural hand gestures, confident posture, direct eye contact.
Audio: no background music.
Maximum 15 seconds per segment; use multiple segments for longer videos
Default resolution is 480p; use 720p for higher quality (same credit cost)
Avatar images must be publicly accessible URLs
speech_text must not exceed ~150 words per segment
Rate Limits
Category
Limit
General API
60 requests / minute
Video generation
1 concurrent job
If you receive a 429 error, wait for the current job to complete before submitting a new one.
Error Handling
Code
Meaning
Action
401
Invalid or missing API key
Check CITEDY_API_KEY is set correctly
402
Insufficient credits
Inform user to top up at citedy.com/dashboard/billing
403
Account not approved or feature not available
Direct user to complete email verification
409
Concurrent job already running
Poll existing job first, then retry
429
Rate limit exceeded
Wait 60 seconds and retry
500
Server error during generation
Retry once after 30 seconds; if persists, note as failed
Response Guidelines
Reply in the user's language — if the user writes in Spanish, respond in Spanish (but use English for API calls)
Always show cost before calling — display total estimated credits and USD before starting any paid operation, and wait for user confirmation
Poll automatically — after submitting /api/agent/shorts, poll every 8 seconds without asking the user
Show progress — inform the user when each step completes: "Script ready... Avatar ready... Generating video (this takes ~60–90s)..."
Return the final URL — always end with the direct download link to the final merged video
Want More?
This skill covers video shorts only. For the full content suite — blog articles, social media adaptations, competitor SEO analysis, lead magnets, and keyword tracking — use the complete citedy-seo-agent skill.
The full agent includes everything in this skill plus:
Automated blog publishing with Autopilot
LinkedIn, X, Reddit, and Instagram social adaptations
AI visibility scanning (Google AI Overviews, ChatGPT, Gemini)
Content gap analysis vs. competitors
Lead magnet generation (checklists, swipe files, frameworks)
