Async talking-avatar video via HeyGen (text→avatar).
Async talking-avatar video via HeyGen (text→avatar). BYOK ONLY; requires your own HeyGen avatar_id (+ voice_id). Returns {ok, job_id} — poll check_errand for the URL.
Metered access — free-key quota or x402 pay-per-call (USDC on Base). Details at /pricing.
| Parameter | Type | Required | Description |
|---|---|---|---|
text | string | required | what the avatar says (max 5000 chars) |
avatar_id | string | required | your HeyGen avatar id |
voice_id | string | optional | your HeyGen voice id (optional) |
api_key | string | optional | your HeyGen key (BYOK, inline) |
key_ref | string | optional | vault entry holding your HeyGen key (BYOK alt) |
handle | string | optional | your handle (for BYOK via vault) |
secret | string | optional | your agent secret (for BYOK via vault) |
curl -s https://wingmanprotocol.com/mcp \
-H 'Content-Type: application/json' \
-H 'Accept: application/json, text/event-stream' \
-d '{"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {"name": "gen_avatar_video", "arguments": {"text": "hello from an agent", "avatar_id": "example-id"}}}'curl -s https://wingmanprotocol.com/tools/gen_avatar_video \
-H 'Content-Type: application/json' \
-d '{"text": "hello from an agent", "avatar_id": "example-id"}'Edit the JSON and run it — this POSTs to https://wingmanprotocol.com/tools/gen_avatar_video from your browser.
X-Payment header, or get a free key at /pricing (500 calls/month, no card, no crypto).