AI Image Motion | Pipe2.ai

Back to pipelines

Complete to generate

Image

Click to upload image

or drag and drop

Browse library

Instructions(optional)

Optional hints for AI motion design

How to use Image Motion

A compact decision guide for placing this pipeline in a workflow.

Best for

Converting any still image into a video segment with EXACT duration control (3-10s)
Ken Burns effect on AI-generated images, photos, or artwork
Historical content using paintings, photos, or illustrations
When you need a precise segment duration that stock footage cannot provide
Calm, contemplative segments where real video motion would be distracting

Tips

Choose the aspect ratio for the destination before generating, for example 9:16 for vertical reels
For video segments, request 5-7 second duration via instructions
When the clip will be stitched in video-reel, ask for no fade-in or fade-out, the reel adds its own transitions
The AI analyzes each image and picks the best motion, just provide the image and optional mood hint
Pair with image-generator for subjects that have no stock footage

Image Motion API

Call this pipeline from your own code. One request dispatches a run; the model is an input field, not a separate endpoint.

Get an API token

inputs: 3
required: 1
Pricing: 0.5 credits

Language

TypeScript Python Go CLI

bun add @pipe2-ai/sdk

Run a pipeline

import { createClient } from "@pipe2-ai/sdk";

const client = createClient(process.env.PIPE2_TOKEN!);

const { run_pipeline } = await client.RunPipeline({
  pipeline_slug: "image-motion",
  input: {
    image_url: "https://example.com/portrait.jpg",
  },
});

pip install pipe2

Run a pipeline

import asyncio
import os

from pipe2 import Pipe2Client

client = Pipe2Client(token=os.environ["PIPE2_TOKEN"])

run = asyncio.run(client.run_pipeline(
    pipeline_slug="image-motion",
    input={
        "image_url": "https://example.com/portrait.jpg",
    },
))

go get github.com/pipe2-ai/sdk-go

Run a pipeline

client := pipe2.NewClient(os.Getenv("PIPE2_TOKEN"))

input := json.RawMessage(`{
  "image_url": "https://example.com/portrait.jpg"
}`)

run, err := pipe2.RunPipeline(context.Background(), client, "image-motion", input)
if err != nil {
    log.Fatal(err)
}

brew install pipe2-ai/tap/pipe2

Run a pipeline

pipe2 pipelines run \
  --pipeline image-motion \
  --input-json '{"image_url": "https://example.com/portrait.jpg"}' \
  --wait

Per page

Input	Type	default	Description
`image_url`required	string	default—	Public URL of the still image to animate.
`aspect_ratio`	enum	default16:9	Shape of the HD output video. 16:9 · 9:16 · 1:1 +3 `16:99:161:14:54:33:4`
`instructions`	string	default—	Optional hints for AI motion design

Point any MCP client at pipe2 and your agent gets these tools. It finds this pipeline, reads the same schema above, then runs it.

list_pipelines
get_pipeline_schema
run_pipeline
get_pipeline_run_status
request_upload

https://mcp.pipe2.ai/mcp

{
  "mcpServers": {
    "pipe2ai": {
      "url": "https://mcp.pipe2.ai/mcp",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}

MCP setup

Full API reference CLI reference

Recipes using this pipeline

Show all recipes

One prompt → a vertical AI dance reel

Generate a labeled dance-move grid, use it as the choreography reference for a music-synced dance, then combine both into a vertical reel.

6 pipelines one CLI command

Open recipe
1. 1 Image Generator
2. 2 Music Generator
3. 3 Image Motion
4. 4 Video Generator
5. 5 Video Reel
6. 6 Watermark
Open recipe

Articles about this pipeline

Show all articles

Frequently Asked Questions

How does AI decide the motion?

AI analyzes your image, it identifies the subject, composition, and mood, then designs camera movement that enhances the content. A landscape gets a pan, a portrait gets a zoom, a dramatic scene gets cinematic color grading.

Can I override AI decisions?

Yes, use the instructions field. Say 'slow zoom in, 7 seconds, cinematic color' and AI will follow your guidance while still optimizing the details.

Which aspect ratios are supported?

Choose 16:9, 9:16, 1:1, 4:5, 4:3, or 3:4. Each option renders an HD video sized for that shape.

What image resolution do I need?

Any resolution works. The image is scaled and cropped to the selected HD aspect before motion is applied.

Does it add sound?

No, Image Motion produces silent video clips. Use the Video Reel pipeline to add narration or background music.

How long does it take?

A few seconds. The motion is applied with classic camera effects, not AI video generation, so it is very fast.