---
title: "Animate one image into a 5 or 10 s clip; optional narration makes the subject speak it (voice + lip-sync)"
method: POST
path: "/videos/image-to-video"
tags: ["Videos"]
---

# Animate one image into a 5 or 10 s clip; optional narration makes the subject speak it (voice + lip-sync)

`POST /videos/image-to-video`

## Request

- Base URL: `https://app.makeaivideo.ai/api/v1`
- URL: `https://app.makeaivideo.ai/api/v1/videos/image-to-video`
- Auth: HTTP bearer

## Request body

- object
  - `image_key` string, required: From /uploads/reference or /uploads/reference-from-url
  - `duration_seconds` 5 | 10
  - `animation_prompt` string
  - `narration` string
  - `voice_id` string
  - `title` string
  - `idempotency_key` string

## Response `202`

Accepted

- object
  - `data` VideoCreated
    - `video_id` string
    - `status` 'generating' | 'draft'
    - `title` string, nullable
    - `scene_count` integer, nullable
    - `poll_after_seconds` integer, nullable
    - `next` string
  - `error` unknown
  - `meta` Meta
    - `request_id` string
    - `timestamp` string, date-time

## Other responses

- `402`: Not enough credits

---

[API](https://skmtc.dev/makeaivideo/apis/makeaivideo-api.md) · [All operations](https://skmtc.dev/makeaivideo/apis/makeaivideo-api/llms.txt) · [OpenAPI document](https://skmtc.dev/makeaivideo/apis/makeaivideo-api/revisions/8c6351087d6d?raw)