Image to Video

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 · 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.

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:

POST`https://api.fashn.ai/v1/run`

Request examples

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"
           }
         }'

Response

Returns a prediction ID for status polling:

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

Input parameters

`image`
Required
image URL | data URI

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 for complete polling details.

Successful response

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

{
  "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 Fundamentals - Authentication, requests, and status polling
Data Retention & Privacy - Understand how FASHN handles your data
Image Preprocessing Best Practices - Improve input quality for better results

Image to Video

POSThttps://api.fashn.ai/v1/run

Response

imageRequiredimage URL | data URI

promptstring

duration5 | 10

resolution480p | 720p | 1080p