Puppetry for AI Agents
Machine-readable capabilities and API integration guide
What Puppetry Can Do
🎬 Text → Video
Provide a portrait image + text script → get a talking head video with AI-generated speech
🎙️ Audio → Video
Provide a portrait image + audio file → get a lip-synced talking head video
🎥 Video → Video
Provide a portrait image + driving video → transfer motion to the portrait
🗣️ 500+ AI Voices
29 languages including Arabic, Hindi, Spanish, French, Japanese, Korean, and more
Machine-Readable Resources
| Resource | URL | Format |
|---|---|---|
| OpenAPI Spec | /openapi.json | OpenAPI 3.1 |
| AI Plugin Manifest | /.well-known/ai-plugin.json | JSON |
| LLMs.txt | /llms.txt | Plain text |
| LLMs Full | /llms-full.txt | Plain text |
| API Docs | /api-docs | HTML |
| Robots.txt | /robots.txt | Plain text |
Quick Start
# 1. Create a talking head video from text
curl -X POST https://puppetry.com/api/v1/animate/text \
-H "Authorization: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"imageURL": "https://example.com/portrait.png",
"inputText": "Hello! Welcome to my channel.",
"outputFormat": "mp4"
}'
# Response: { "taskId": "abc-123", "status": "PENDING" }
# 2. Poll for completion
curl https://puppetry.com/api/v1/task/abc-123 \
-H "Authorization: YOUR_API_KEY"
# Response: { "status": "SUCCESS", "video_url": "https://..." }Integration Ideas
- 📚 Education platforms: Auto-generate instructor videos from course scripts
- 📧 Email marketing: Personalized video messages at scale
- 🛒 E-commerce: Product demo videos from product descriptions
- 📰 News/content: Convert articles into video summaries
- 💬 Customer support: Video responses to common questions
- 🎮 Game dev: NPC dialogue videos from character portraits
- 🌐 Localization: Translate and re-voice videos in 29 languages
In-House Agent Team
Puppetry ships with four first-party AI teammates—Max, Emma, Bill, and Bobby—who can join your workspace via Slack or webhook callbacks so you always know which assistant is on call.
Max
Product strategy & orchestration
- Designs multi-step launches and keeps campaigns on brief.
- Dispatches the right teammate for each Slack/webhook request.
- Shares weekly API performance tips with your ops dashboards.
Emma
Research & messaging intelligence
- Runs qualitative studies on scripts before you record.
- Turns customer transcripts into crisp video briefs.
- Keeps localization playbooks current across 29 languages.
Bill
Hands-on engineering partner
- Runs on OpenAI GPT-5.1 Codex for Puppetry coding work.
- Builds and reviews API automations directly from Slack.
- Surfaces lint/test results back to your CI channels.
Bobby
Workflow hygiene & follow-through
- Keeps standups and reminders flowing in shared Slack rooms.
- Confirms deliverables ship on time via webhook callbacks.
- Escalates blockers before they impact production volume.
Limits & Pricing
Free tier includes limited video generations. Pro plans offer higher quotas and no watermarks. See pricing for details.
For enterprise API access or custom integrations, contact support@puppetry.com