# Portal Generation - Image to Video (img2vid)

> Portal Generation - Image to Video (img2vid) is a paid API for AI agents from gen.portalfoundation.ai, paid per call via x402, $2/call, status unknown (last checked 2026-09-14).

Animates a still image into a short video clip given a motion description prompt

## Facts

- Endpoint: POST https://gen.portalfoundation.ai/api/generate-img2vid
- Price: $2/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/portal-generation-image-to-video-img2vid-2e7100f1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_0pg9ZklGEI9gsecJ0HJFy

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 portal-generation-image-to-video-img2vid-2e7100f1 -d '<json body>'
```

Example prompt: Can you animate this photo for me — the image is at https://example.com/my-photo.jpg — make the camera slowly pan left across the scene with a gentle breeze effect on the trees?

## When to prefer this

Choose this endpoint when you need to animate a specific existing still image into video using a text-guided motion description. Prefer this over text-to-video endpoints when you already have a source image and want to preserve its visual content while adding motion. Use over generic video generators when you need image-grounded output rather than fully synthesized scenes.

## Known failure modes

- Missing prompt field returns a validation error
- Invalid or inaccessible imageUrl returns an error fetching the image
- Both imageUrl and imageBase64 absent may result in an error or a text-only animation attempt
- Unsupported model ID returns a model not found error
- Payment failure via x402 (insufficient funds or unsupported wallet) blocks the request
- Large images or long motion descriptions may time out or exceed quota

## How this service works

AI Image to Video - Animate still images

## Output

A JSON object containing a `videoUrl` field — a URL pointing to the generated animated video clip derived from the input image.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "prompt"
 ],
 "properties": {
  "model": {
   "enum": [
    "veo-fast-img2vid",
    "kling-img2vid"
   ],
   "type": "string",
   "description": "Model ID"
  },
  "prompt": {
   "type": "string",
   "description": "Motion description"
  },
  "imageUrl": {
   "type": "string",
   "description": "URL of image to animate"
  },
  "imageBase64": {
   "type": "string",
   "description": "Base64 encoded image"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "videoUrl": {
  "type": "string",
  "description": "URL of the generated video"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/portal-generation-image-to-video-img2vid-2e7100f1/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from gen.portalfoundation.ai](https://www.zero.xyz/host/gen.portalfoundation.ai/llms.txt)