Puppetry for AI Agents

# 1. List public Puppetry voices (GET /api/v1/voices/puppetry)
curl https://www.puppetry.com/api/v1/voices/puppetry \
  -H "Authorization: Bearer YOUR_API_KEY"

# Response item: { "id": "puppetry-af_heart", "name": "Heart", "language_code": "en", "preview_url": "/api/voices/puppetry-preview?voice=af_heart&language=en" }

# 2. Generate speech with a Puppetry voice (POST /api/v1/tts/puppetry)
curl -X POST https://www.puppetry.com/api/v1/tts/puppetry \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "voice_id": "puppetry-af_heart",
    "text": "Hello! Welcome to my channel.",
    "speed": 1
  }'

# Response: { "audio_url": "https://...", "usage": { "voice_characters": { ... } } }

AUDIO_FILE="./audio.mp3"
CONTENT_LENGTH=$(wc -c < "$AUDIO_FILE" | tr -d ' ')

# 3. Create a hosted upload URL for existing audio (POST /api/v1/uploads/audio-url)
UPLOAD_BODY=$(node -e "console.log(JSON.stringify({mime_type: 'audio/mpeg', content_length: Number(process.argv[1])}))" "$CONTENT_LENGTH")
UPLOAD_JSON=$(curl -sS -X POST https://www.puppetry.com/api/v1/uploads/audio-url \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d "$UPLOAD_BODY")

UPLOAD_URL=$(node -e "const r=JSON.parse(process.argv[1]); console.log(r.upload_url)" "$UPLOAD_JSON")
READ_URL=$(node -e "const r=JSON.parse(process.argv[1]); console.log(r.read_url)" "$UPLOAD_JSON")

curl -sS -X PUT "$UPLOAD_URL" \
  -H "Content-Type: audio/mpeg" \
  -H "Content-Length: $CONTENT_LENGTH" \
  --upload-file "$AUDIO_FILE"

printf "\nSigned read URL:\n%s\n" "$READ_URL"