# Avatar Lip-Sync Video

> Avatar Lip-Sync Video is a paid API for AI agents from agents.vimmerse.net, paid per call via MPP, price unknown, status unknown (last checked 2026-10-31).

Generates a talking-avatar video by syncing a selected avatar and voice to a provided speech script, with optional background image, captions, and aspect ratio.

## Facts

- Endpoint: POST https://agents.vimmerse.net/v2/video/avatars/lip-sync?utm_source=zero.xyz
- Price: price unknown
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-31
- Activations on Zero: 0
- Provider: agents.vimmerse.net
- Website: https://agents.vimmerse.net
- Canonical page: https://www.zero.xyz/c/agents-vimmerse-net-avatar-lip-sync-video-455af0cf
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_rQt4rrk83wTjrJcY26ShI

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agents-vimmerse-net-avatar-lip-sync-video-455af0cf -d '<json body>'
```

Example prompt: Create a talking-avatar video using avatar ID 'av_male_001' and voice ID 'voice_en_us_02', with this script: 'Welcome to our platform — we make your ideas come to life.' Use a 16:9 aspect ratio, show captions, and use this background image: https://example.com/bg.jpg

## When to prefer this

Choose this endpoint when you need a talking-avatar video where a specific pre-built avatar persona speaks a custom script with lip-sync, especially for spokesperson content, marketing clips, e-learning, or social media. Prefer this over general video generation when avatar identity and lip-sync accuracy are the priority. Use async_mode with a webhook when rendering time is a concern for long scripts.

## Known failure modes

- Invalid or unrecognized avatar_id — avatar not found or not accessible
- Invalid or unrecognized voice_id — voice not available
- Empty or missing prompt with no audio_url fallback — no speech content to sync
- Invalid aspect_ratio value — must be '1:1', '16:9', or '9:16'
- Unreachable bg_image_url or audio_url — network fetch failure
- Insufficient credits — payment or credit balance too low
- Async job failure — job ID returned but rendering fails downstream; must poll for status
- Webhook delivery failure — webhook_url unreachable or returns non-200

## How this service works

Creatify talking-avatar video. Provide **`avatar_id`**, **`voice_id`**, and **`prompt`**. Optional **`bg_image_url`**, **`audio_url`**, **`aspect_ratio`** (`1:1`, `16:9`, `9:16`), **`show_caption`** (`On`/`Off`).

List avatars/voices via internal **GET** routes (not in public schema).

## Output

Returns a video asset (or a job ID in async mode) representing the rendered talking-avatar clip, where the chosen avatar's mouth and face are lip-synced to the provided speech script using the selected voice, composed over the optional background image at the specified aspect ratio, with or without burned-in captions.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "title": "AvatarLipSyncRequest",
 "properties": {
  "prompt": {
   "type": "string",
   "title": "Prompt",
   "default": "",
   "description": "Speech script for the avatar."
  },
  "voice_id": {
   "type": "string",
   "title": "Voice ID",
   "default": ""
  },
  "audio_url": {
   "type": "string",
   "title": "Background Audio URL",
   "default": ""
  },
  "avatar_id": {
   "type": "string",
   "title": "Avatar ID",
   "default": ""
  },
  "async_mode": {
   "type": "boolean",
   "title": "Async Mode",
   "default": false
  },
  "webhook_url": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "null"
    }
   ],
   "title": "Webhook URL"
  },
  "aspect_ratio": {
   "type": "string",
   "title": "Aspect Ratio",
   "default": "16:9",
   "description": "`1:1`, `16:9`, or `9:16`."
  },
  "bg_image_url": {
   "type": "string",
   "title": "Background Image URL",
   "default": ""
  },
  "show_caption": {
   "type": "string",
   "title": "Show Caption",
   "default": "On",
   "description": "`On` or `Off`."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-vimmerse-net-avatar-lip-sync-video-455af0cf/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.vimmerse.net](https://www.zero.xyz/host/agents.vimmerse.net/llms.txt)