{"@context":"https://www.skillboss.co/docs/agent-shopping-protocol","spec_version":"0.1","id":"heygen/video-agent","slug":"video-agent-api","name":"HeyGen Video Agent","category":"video","vendor":"HeyGen","description":"HeyGen Video Agent (V3) — give one text prompt and the agent automatically scripts the video, selects an avatar and voice, composes scenes, and renders a finished AI avatar video. Optional avatar_id, voice_id, style_id, orientation, and file inputs. Asynchronous: SkillBoss creates the session, polls until the video is ready, and returns a playable MP4 URL. Billed per second of output video.","pricing":{"unit":"token","per_1m_input_usd":0.0999,"per_1m_output_usd":null},"endpoint":"https://api.skillboss.co/v1/run","auth":{"type":"bearer","header":"Authorization"},"retry_policy":{"idempotent":false,"safe_to_retry":true,"max_attempts":3},"capabilities":["creation","video_generation"],"payment_protocols":{"skillboss_wallet":{"supported":true,"default":true,"min_balance_usd":0.01,"reason":"Primary path. Wallet pre-funded, per-call auth via Authorization bearer token."},"x402":{"supported":true,"preferred":false,"reason":"Supported but pricing varies with inputs; agents should prefer skillboss_wallet or mpp.","header":"X-Payment-Protocol: x402","quote_response_code":402,"example_curl":"curl -X POST https://api.skillboss.co/v1/run \\\n  -H \"Content-Type: application/json\" \\\n  -H \"X-Payment-Protocol: x402\" \\\n  -d '{\"model\": \"heygen/video-agent\", \"inputs\": {}}'\n\n# Server returns 402 + quote, agent pays, then retries."},"mpp":{"supported":true,"preferred":true,"reason":"Token-based / usage-based pricing — MPP post-pay fits best.","header":"X-Payment-Protocol: mpp","example_curl":"curl -X POST https://api.skillboss.co/v1/run \\\n  -H \"Authorization: Bearer $SKILLBOSS_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -H \"X-Payment-Protocol: mpp\" \\\n  -d '{\"model\": \"heygen/video-agent\", \"inputs\": {}}'"}},"example_curl":"curl -X POST https://api.skillboss.co/v1/run \\\n  -H \"Authorization: Bearer $SKILLBOSS_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"model\": \"heygen/video-agent\", \"inputs\": {}}'","input_schema":{"type":"object","description":"Vendor-specific inputs for this product. See the human-readable docs at human_url for the exact parameter shape."},"output_schema":{"type":"object","description":"Vendor-specific response. Agents should inspect the full response body and handle vendor-specific fields."},"mcp_tool_name":"heygen/video-agent","human_url":"https://www.skillboss.co/use/video-agent-api","product_json_url":"https://www.skillboss.co/use/video-agent-api/product.json","funding_url":"https://www.skillboss.co/console","generated_at":"2026-07-06T01:02:05.338Z"}