> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hypergate.store/llms.txt
> Use this file to discover all available pages before exploring further.

# Image to Video

> Generate a video from a reference image using image-to-video models.

## Overview

Image-to-video models animate a reference image based on a text prompt. The output video preserves the subject and composition of the input image while adding motion.

## Which models support this?

Check the `id` field from `GET /v1/models` — image-to-video models contain `image-to-video` in their ID:

```
bytedance/seedance-2.5/image-to-video
kwaivgi/kling-v2.5-pro/image-to-video
```

## Requirements

* The `image` field is **required** for these models
* The URL must be **publicly accessible** (not behind auth, not a presigned URL that expires)
* Supported formats: JPEG, PNG, WebP

## Example

```bash theme={null}
curl -X POST https://hypergate.store/v1/videos \
  -H "Authorization: Bearer <your-token>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bytedance/seedance-2.5/image-to-video",
    "prompt": "The character slowly turns their head and smiles",
    "image": "https://your-cdn.com/keyframe.jpg",
    "duration": 5,
    "aspect_ratio": "16:9"
  }'
```

<Warning>Submitting an image-to-video model **without** an `image` field will return HTTP 400.</Warning>