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

# Video

> Create animations from your images

# Video

Transform your static images into animated videos to present your spaces in a dynamic and immersive way.

## How It Works

Our AI converts your images into video sequences by:

* Adding fluid camera movements
* Creating 3D depth from 2D images
* Simulating movement through space
* Maintaining high visual quality

## Use Cases

* Animated virtual tours for real estate
* More engaging presentations of architectural projects
* Interactive content for social media
* Dynamic showcasing of renovated spaces

## API

Integrate this feature into your applications:

```bash theme={null}
curl --request POST \
--url 'https://iacrea.com/api/animation/v2/generate' \
--header 'x-api-key: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
  "user_id": "your-user-id",
  "image_urls": ["https://example.com/image.jpg"],
  "option": "ZOOM_OUT",
  "prompt": "Elegant modern living room",
  "format": "mp4"
}'
```

### Available Animation Options

Possible values for the `option` parameter are:

* `ZOOM_IN`: Zoom-in effect towards the inside of the image
* `ZOOM_OUT`: Zoom-out effect moving away from the image
* `PAN_RIGHT`: Camera movement to the right
* `PAN_LEFT`: Camera movement to the left
* `PAN_UP`: Camera movement upward
* `PAN_DOWN`: Camera movement downward
* `CAMERA_PUSH_OUT`: Fluid movement combining zoom and displacement
* `AUTO_EFFECTS`: Automatic prompt generation by AI to create optimal animation
* `AUTO_REVERSE`: Automatic prompt generation by AI to create reverse animation

### Retrieve Results

Get the results of a video generation:

```bash theme={null}
curl --request POST \
--url 'https://iacrea.com/api/animation/v2/get' \
--header 'x-api-key: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
  "user_id": "your-user-id",
  "generation_id": "your-generation-id"
}'
```

Video generation typically takes a few minutes. During processing, the returned status will be `STARTING` then `PROCESSING`. Once completed, you will receive a `SUCCEEDED` status with the URL of your video.

### Example of Successful Response

```json theme={null}
{
  "status": "SUCCEEDED",
  "urls": ["https://url-of-your-video.mp4"]
}
```

## Tips

* Use high-quality images for better results
* Choose photos with good visual depth
* Test different animation types to find the effect most suited to your space
* Use the `prompt` parameter to guide the visual style of the animation
* Combine with our other services to create complete virtual tours