API reference
Menivor public endpoints — reels, templates, trends, and analytics.
Authentication: send your API key as the x-api-key request header.
Reels
Submit a new avatar-reel render job. The pipeline writes a hook-driven script, synthesises a voiceover, lip-syncs a HeyGen presenter, burns karaoke captions, and renders a 9:16 MP4. One credit is debited on submission and refunded if the render fails.
Authentication: send your API key as the x-api-key request header.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| params.video_subject | body | string | required | Topic brief for the AI script generator.e.g. "How to set up Stripe webhooks in 60 seconds" |
| params.voice_name | body | string | required | ElevenLabs voice id prefixed with "elevenlabs:", e.g. "elevenlabs:21m00Tcm4TlvDq8ikWAM".e.g. "elevenlabs:21m00Tcm4TlvDq8ikWAM" |
| params.avatar_id | body | string | required | HeyGen avatar id or stored preset id.e.g. "Angela-inTshirt-20220820" |
| params.layout | body | "pip" | "hook_intro" | "split" | "captions_only" | required | Composition layout the compose stage renders.e.g. "pip" |
| params.aspect | body | "9:16" | "1:1" | "16:9" | optional | Output aspect ratio. Defaults to 9:16 (vertical).e.g. "9:16" |
| params.language | body | "en" | "tr" | "auto" | optional | Script language. auto detects from the subject.e.g. "en" |
| variants | body | number (1–3) | optional | Fan out N A/B variants in a single request.e.g. 1 |
Example request
curl -X POST https://api.menivor.com/api/v1/jobs \
-H "x-api-key: <your-api-key>" \
-H "Content-Type: application/json" \
-d '{
"params": {
"video_subject": "How to set up Stripe webhooks in 60 seconds",
"voice_name": "elevenlabs:21m00Tcm4TlvDq8ikWAM",
"avatar_id": "Angela-inTshirt-20220820",
"layout": "pip",
"aspect": "9:16",
"language": "en",
"caption_style": "karaoke_yellow",
"target_duration_s": 60,
"platforms": ["tiktok", "instagram"]
}
}'Response shape
{
"status": 200,
"data": {
"job_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"state": 1,
"progress": 0,
"correlation_id": "req_abc123"
}
}