# Image to Video

Create short videos from a single image with tasteful camera work and model movements tailored for fashion.

Image to Video turns a still image into a short motion clip, with tasteful camera work and model movements tailored for fashion. Provide a starting image, add motion guidance if needed, and include an ending image when you want the clip to transition toward a specific final frame.

**Lifecycle:** [Experimental](/api-overview/model-lifecycle) · **Released:** October 15, 2025

## Request body

Every call uses the universal `POST /v1/run` request body:

| Field        | Type   | Required | Description                                                                                       |
| ------------ | ------ | -------- | ------------------------------------------------------------------------------------------------- |
| `model_name` | string | Yes      | Must be `image-to-video`.                                                                         |
| `inputs`     | object | Yes      | Contains the endpoint-specific parameters documented under [Input parameters](#input-parameters). |

Place all endpoint parameters inside `inputs`; they are not top-level request fields.

## Request

Animate a single image into a short video via the universal `/v1/run` endpoint:

    #### Request examples

        ```bash
        curl -X POST https://api.fashn.ai/v1/run \
             -H "Content-Type: application/json" \
             -H "Authorization: Bearer YOUR_API_KEY" \
             -d '{
                   "model_name": "image-to-video",
                   "inputs": {
                     "image": "https://example.com/photo.jpg",
                     "duration": 5,
                     "resolution": "1080p"
                   }
                 }'
        ```

        ```js
        fetch('https://api.fashn.ai/v1/run', {
          method: 'POST',
          body: JSON.stringify({
            model_name: "image-to-video",
            inputs: {
              image: "https://example.com/photo.jpg",
              duration: 5,
              resolution: "1080p"
            }
          }),
          headers: {
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/json',
          }
        });
        ```

        ```python
        import requests

        response = requests.post(
          "https://api.fashn.ai/v1/run",
          headers={
            "Authorization": "Bearer YOUR_API_KEY",
            "Content-Type": "application/json"
          },
          json={
            "model_name": "image-to-video",
            "inputs": {
              "image": "https://example.com/photo.jpg",
              "duration": 5,
              "resolution": "1080p"
            }
          }
        )
        ```

    #### Response

        Returns a prediction ID for status polling:

          **Example Response:**

            ```json
            {
              "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1-u1",
              "error": null
            }
            ```

## Input parameters

**image** (`image URL | data URI`) *required*

Source image to animate into a short video.

**prompt** (`string`)

Optional motion guidance. Detailed prompting is not recommended because motion is difficult to control precisely. For the best results, leave this field empty and allow the system to plan motion automatically. If you choose to include guidance, keep it short and concrete, for example: "raising hand to touch face".

**Default:** Empty string (automatic motion)

**duration** (`5 | 10`)

Duration of the generated video in seconds.

**Default:** `5`

**resolution** (`480p | 720p | 1080p`)

Target video resolution used by the video engine.

**Default:** `1080p`

**end_image** (`image URL | data URI`)

Optional image to use as the final frame of the generated video. When
  provided, the video smoothly transitions from `image` (start frame) to
  `end_image` (end frame) over the clip duration.

## Technical limitations

| Requirement        | Limit            |
| ------------------ | ---------------- |
| Image file size    | 30 MiB per image |
| Minimum dimensions | 301 × 301 px     |

Images outside these limits fail with `InputValidationError`. FASHN does not upscale undersized images.

## Credit cost

| `duration` \ `resolution` | `480p` | `720p` | `1080p` |
| ------------------------- | ------ | ------ | ------- |
| `5s`                      | 1      | 3      | 6       |
| `10s`                     | 2      | 6      | 12      |

## Response polling

After submitting your request, poll the status endpoint using the returned prediction ID. See [API Fundamentals](/api-overview/api-fundamentals#status-polling) for complete polling details.

### Successful response

When your video completes successfully, the status endpoint will return:

```json
{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1-u1",
  "status": "completed",
  "output": [
    "https://cdn.fashn.ai/123a87r9-4129-4bb3-be18-9c9fb5bd7fc1-u1/output_0.mp4"
  ],
  "error": null
}
```

The `output` array contains URLs to your generated MP4 video(s). The number of items reflects the workflow’s output (currently 1 video per request).

## Runtime errors

Runtime errors for Image to Video use the shared set in [Error Handling](/api-overview/error-handling#common-runtime-errors).

## Related guides

- **[API Fundamentals](/api-overview/api-fundamentals)** - Authentication, requests, and status polling
- **[Data Retention & Privacy](/api-overview/data-retention-privacy)** - Understand how FASHN handles your data
- **[Image Preprocessing Best Practices](/guides/image-preprocessing-best-practices)** - Improve input quality for better results