# Image to video v3
**Action ID:** `image_to_video_v3`
## Description
Image to video v3
## Connection
| Name | Description | Required | Category |
| ------------------ | ------------------------------------------- | -------- | -------- |
| PixelML Connection | The PixelML connection to call PixelML API. | True | pixelml |
## Input Parameters
| Name | Type | Required | Default | Description |
| ---------------- | -------------- | :------: | ------- | ------------------------------------------------------------------------- |
| prompt | string | ✓ | - | Text description guiding the video generation. Max length: 904 characters |
| image | string | ✓ | - | URL of the starting image that will be animated into video |
| negative\_prompt | string or null | - | null | Description of elements to avoid in the video. Max length: 904 characters |
| steps | integer | - | 20 | Number of generation steps for quality. Range: 1 to 50 |
| guidance\_scale | integer | - | 3 | How closely to follow the prompt. Range: 1 to 10 |
| frame\_rate | integer | - | 8 | Video frames per second. Range: 1 to 30 |
View JSON Schema
```json
{
"description": "Image to video node input.",
"properties": {
"prompt": {
"description": "Prompt",
"maxLength": 904,
"title": "Prompt",
"type": "string"
},
"image": {
"description": "Start image of the video.",
"title": "Start image",
"type": "string"
},
"negative_prompt": {
"anyOf": [
{
"maxLength": 904,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Negative prompt",
"title": "Negative prompt"
},
"steps": {
"default": 20,
"description": "Steps",
"maximum": 50,
"minimum": 1,
"title": "Steps",
"type": "integer"
},
"guidance_scale": {
"default": 3,
"description": "Guidance scale",
"maximum": 10,
"minimum": 1,
"title": "Guidance scale",
"type": "integer"
},
"frame_rate": {
"default": 8,
"description": "Frame rate",
"maximum": 30,
"minimum": 1,
"title": "Frame rate",
"type": "integer"
}
},
"required": [
"prompt",
"image"
],
"title": "ImageToVideoV3NodeInput",
"type": "object"
}
```
## Output Parameters
| Name | Type | Description |
| ----- | ------ | ------------------------------- |
| video | string | URL to the generated video file |
View JSON Schema
```json
{
"description": "Image to video node output.",
"properties": {
"video": {
"description": "Rendered video",
"title": "Rendered video",
"type": "string"
}
},
"required": [
"video"
],
"title": "ImageToVideoV3NodeOutput",
"type": "object"
}
```
## How It Works
This node uses AI-powered video generation technology through the PixelML API to transform a static image into a dynamic video. It takes your starting image and prompt describing the desired motion or animation, then generates frames that smoothly animate the image according to your description. The generation process is controlled by parameters like steps for quality, guidance\_scale for prompt adherence, and frame\_rate for smoothness.
## Usage Examples
### Example 1: Animate Product Shot
**Input:**
```
prompt: "Slowly rotating 360 degrees, smooth professional product showcase"
image: "https://example.com/images/sneaker.jpg"
negative_prompt: "blurry, distorted, low quality"
steps: 30
guidance_scale: 5
frame_rate: 24
```
**Output:**
```
video: "https://storage.pixelml.com/videos/product_rotation_12345.mp4"
```
### Example 2: Create Nature Scene Animation
**Input:**
```
prompt: "Clouds moving slowly across the sky, gentle breeze rustling leaves"
image: "https://example.com/images/mountain_landscape.jpg"
negative_prompt: "jerky motion, unnatural movement, artifacts"
steps: 25
guidance_scale: 4
frame_rate: 15
```
**Output:**
```
video: "https://storage.pixelml.com/videos/nature_scene_67890.mp4"
```
### Example 3: Portrait Animation
**Input:**
```
prompt: "Person smiling and looking at camera, subtle head movement"
image: "https://example.com/images/portrait.jpg"
negative_prompt: "distorted face, unnatural expressions, glitches"
steps: 40
guidance_scale: 6
frame_rate: 30
```
**Output:**
```
video: "https://storage.pixelml.com/videos/portrait_animation_24680.mp4"
```
## Common Use Cases
* **Product Marketing Videos**: Transform static product images into engaging 360-degree rotation videos for e-commerce
* **Social Media Content**: Create eye-catching animated posts from still images for Instagram, TikTok, or Facebook
* **Real Estate Tours**: Animate property photos to create immersive virtual walkthroughs
* **Digital Art Animation**: Bring artwork and illustrations to life with subtle movements and effects
* **Profile Pictures**: Create animated avatars or profile pictures from static headshots
* **Presentation Enhancement**: Convert slide images into dynamic video segments for more engaging presentations
* **Advertisement Creation**: Generate video ads from product photography without expensive video shoots
## Error Handling
| Error Type | Cause | Solution |
| -------------------------- | ---------------------------------------------------------- | ------------------------------------------------------------------ |
| Invalid Image URL | Image URL is inaccessible or malformed | Ensure the image URL is publicly accessible and properly formatted |
| Image Format Not Supported | Image is in an unsupported format | Use common image formats like JPG, PNG, or WebP |
| Prompt Too Long | Prompt exceeds 904 character limit | Shorten the prompt while maintaining key description elements |
| Invalid Parameter Range | steps, guidance\_scale, or frame\_rate outside valid range | Ensure all numeric parameters are within their specified ranges |
| Generation Failed | AI model encountered an error during processing | Try with different prompt wording or reduce complexity |
| Connection Timeout | PixelML API connection or generation took too long | Retry the request or check PixelML service status |
| Insufficient Resources | Generation requires more resources than available | Reduce steps or frame\_rate to decrease computational requirements |
## Notes
* **PixelML Connection Required**: This node requires a valid PixelML connection to access the image-to-video generation API.
* **Generation Time**: Video generation can take several minutes depending on steps and frame\_rate; higher values produce better quality but take longer.
* **Image Quality**: Higher resolution input images generally produce better video output; ensure your starting image is clear and well-composed.
* **Prompt Specificity**: Detailed prompts describing the desired motion lead to better results (e.g., "slowly rotating clockwise" vs. "rotating").
* **Negative Prompts**: Use negative prompts to avoid unwanted artifacts like "blurry", "distorted", "jerky motion", or "low quality".
* **Steps Parameter**: Higher steps (30-50) produce smoother, higher-quality videos but increase generation time significantly.
* **Guidance Scale**: Lower values (1-3) allow more creative interpretation; higher values (7-10) stick more closely to the prompt.
* **Frame Rate**: Standard frame rates are 24fps (cinematic), 30fps (smooth), or 8-15fps (stylized); higher frame rates increase file size.
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.agenticflow.ai/reference/nodes/image_to_video_v3.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.