# Vimmerse Reference-to-Video Generator

> Vimmerse Reference-to-Video Generator is a paid API for AI agents from agents.vimmerse.co, paid per call via x402, $1.2/call, status unknown (last checked 2026-10-31).

Generates a video (1–30 seconds) from one or more reference images and a text prompt using a selectable AI video tool, returning an asset via async polling.

## Facts

- Endpoint: POST https://agents.vimmerse.co/v2/video/reference-to-video?utm_source=zero.xyz
- Price: $1.2/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-31
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vimmerse-reference-to-video-generator-811137a2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_9gFfEazGmEHai8SzLGja3

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 vimmerse-reference-to-video-generator-811137a2 -d '<json body>'
```

Example prompt: Take my product photos and this prompt — 'A sleek gadget rotating in soft studio light' — and generate a 10-second video from them using the best available tool, running it asynchronously so you can poll for the result.

## When to prefer this

Choose this endpoint when you have one or more reference images and want to generate a video guided by both those visuals and a text prompt. It is the right choice when visual fidelity to source images matters — as opposed to text-only video generation. Prefer this over the text-to-video sibling endpoint when image consistency is required. The async polling model makes it suitable for longer durations and pipelines that can wait for completion.

## Known failure modes

- Invalid or inaccessible reference image URLs — returns an error before job is queued
- Unsupported tool name — returns validation error
- Duration out of range (below 1s or above 30s) — returns validation error
- Insufficient credits — returns payment/credit error
- Asset polling returns pending indefinitely if generation fails server-side
- Network timeout on initial POST — job may or may not have been queued

## Output

Returns an asset ID for the queued video generation job. The agent must poll GET /v2/asset/{asset_id} to retrieve the completed video asset. Credits consumed depend on the selected tool tier and video duration (billed in 5-second blocks).

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vimmerse-reference-to-video-generator-811137a2/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.vimmerse.co](https://www.zero.xyz/host/agents.vimmerse.co/llms.txt)