# Vimmerse Video Effects

> Vimmerse Video Effects is a paid API for AI agents from agents.vimmerse.net, paid per call via MPP, $1.2/call (dynamic — varies by input), status unknown (last checked 2026-10-31).

Applies a named motion effect (e.g. BulletTime, hug) to one or two input images, generating a short video clip via selectable provider backends.

## Facts

- Endpoint: POST https://agents.vimmerse.net/v2/video/video-effects?utm_source=zero.xyz
- Price: $1.2/call (dynamic — varies by input)
- 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-vimmerse-video-effects-b68de493
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_AqU8YnTo-kvc4SqQ3_NJR

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-vimmerse-video-effects-b68de493 -d '<json body>'
```

Example prompt: Take this photo of me (https://example.com/me.jpg) and apply a BulletTime effect using HiggsfieldEffects to generate 1 animated video clip.

## When to prefer this

Choose this endpoint when you need to animate a static image with a specific named motion effect (e.g. BulletTime, hug, zoom) and want to select from multiple provider backends (Pika, Kling, Wan, Vidu, Pixverse, Higgsfield). It is especially useful for two-subject interaction effects (hug, handshake) that require a reference image, and when you want provider-level control over the underlying generation model.

## Known failure modes

- Invalid or inaccessible image_url returns an error or empty response
- Unsupported effect name for the chosen provider option causes generation failure
- Invalid aspect_ratio format (must match d+:d+ pattern) returns a validation error
- ref_image_url required for two-subject effects but not provided leads to poor results or error
- Insufficient credits / payment failure returns 402
- Provider backend timeout or unavailability returns a 5xx error
- quantity exceeds maximum of 4 returns validation error

## How this service works

Motion effect from **`image_url`**. Use **`ref_image_url`** for two-subject effects (e.g. hug). Set **`aspect_ratio`** when the provider supports it.

**`option`:** `PikaEffects`, `KlingEffects`, `WanEffects`, `ViduEffects`, `PixverseEffects`, `HiggsfieldEffects`

## Output

Returns a video job result (synchronously or via webhook in async mode) containing the generated video clip(s) with the applied motion effect, along with job metadata such as media ID and status. In async mode, a job ID is returned immediately for polling.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "title": "VideoEffectsRequest",
 "required": [
  "image_url"
 ],
 "properties": {
  "effect": {
   "type": "string",
   "title": "Effect name",
   "default": "BulletTime"
  },
  "option": {
   "type": "string",
   "title": "Effects tool",
   "default": "HiggsfieldEffects"
  },
  "prompt": {
   "type": "string",
   "title": "Prompt",
   "default": ""
  },
  "quantity": {
   "type": "integer",
   "title": "Quantity",
   "default": 1,
   "maximum": 4,
   "minimum": 1
  },
  "image_url": {
   "type": "string",
   "title": "Base image URL"
  },
  "async_mode": {
   "type": "boolean",
   "title": "Async Mode",
   "default": false
  },
  "webhook_url": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "null"
    }
   ],
   "title": "Webhook URL"
  },
  "aspect_ratio": {
   "anyOf": [
    {
     "type": "string",
     "pattern": "^(\\d+):(\\d+)$"
    },
    {
     "type": "null"
    }
   ],
   "title": "Aspect Ratio"
  },
  "ref_image_url": {
   "type": "string",
   "title": "Optional reference image URL",
   "default": ""
  }
 }
}
```

## Response schema (JSON Schema)

```json
{}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-vimmerse-net-vimmerse-video-effects-b68de493/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)