Skip to main content

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

ResourceURLFormat
OpenAPI Spec/openapi.jsonOpenAPI 3.1
AI Plugin Manifest/.well-known/ai-plugin.jsonJSON
LLMs.txt/llms.txtPlain text
LLMs Full/llms-full.txtPlain text
API Docs/api-docsHTML
Robots.txt/robots.txtPlain 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