Image to Video

Image to Video turns a single image into a short motion clip, with tasteful camera work and model movements tailored for fashion. Provide an image and optional instructions to produce engaging 5–10 second videos at up to 1080p.

Model Specifications

Model Name: image-to-video
Lifecycle: experimental
Duration Options: 5s, 10s
Resolutions: 480p, 720p, 1080p
Output: MP4 video URLs
Credits: 1-12 per output video depending on resolution and duration

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
}

Request Parameters

Required Parameters

`image`
Required
image URL | base64

Source image to animate into a short video.

Base64 Format

Base64 images must include the proper prefix (e.g., data:image/jpg;base64,<YOUR_BASE64>)

Optional Parameters

`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 internal video engine.

Default: 1080p

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 | base64

promptstring

duration5 | 10

resolution480p | 720p | 1080p

On this page

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

`image`
Required
image URL | base64

`prompt`string

`duration`5 | 10

`resolution`480p | 720p | 1080p