Image to Video

The Image to Video endpoint brings static images to life by generating a high-quality video animation based on a text prompt.

Model Name: image-to-video

Lifecycle: experimental

Processing Time: ~60s–180s

Output Format: MP4

Delivery Methods: URL (via status polling)

Credits: 6 to 12 per video (depends on duration)

Request

Generate a video by submitting your image and prompt to the universal /v1/run endpoint:

POSThttps://fititon.app/api/v1/run

Request Examples

curl -X POST https://fititon.app/api/v1/run \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -d '{
           "model_name": "image-to-video",
           "inputs": {
             "imageUrl": "https://example.com/product.jpg",
             "prompt": "Camera pans slowly around the model as she walks forward",
             "duration": 6,
             "aspectRatio": "9:16"
           }
         }'

Response

Because video generation takes several minutes, the /v1/run endpoint returns a 200 OK status immediately with an asynchronous job id. You must poll the Status API using GET /v1/status/{id} to retrieve the final MP4 URL. Alternatively, you can configure webhooks to receive notifications automatically. Please note that our webhook dispatcher enforces a strict 15-second timeout. Your server must acknowledge the webhook with a 2xx status code within 15 seconds, or we will consider it failed and retry it later.

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "starting",
  "created_at": "2026-07-18T17:30:00.000Z",
  "error": null,
  "output": null
}

Request Parameters

Required Parameters

imageUrlRequiredstring

The input image to animate. Can be a publicly accessible URL or a Base64-encoded image string.

Pro Tip: Images with visible hair, fabric, or foliage produce the most natural-looking motion. Static flat-lay or product-only photos don't animate well — use images with a person or scene. Avoid heavily cropped images to give the AI space for movement.

Formatting Requirement When submitting a Base64 string, it must include the standard data URI prefix (e.g., data:image/jpeg;base64,...).

Optional Parameters

promptstring

A textual description guiding the animation. If omitted, the AI will infer natural movement from the image context.

durationinteger

The length of the generated video in seconds. Supported values: 4, 6, 8. Default: 6

aspectRatio'16:9' | '9:16'

The aspect ratio of the output video. Default: 9:16

generateAudioboolean

Whether to generate contextual AI audio to accompany the video. Default: true

Runtime Errors

Runtime errors for this feature use the shared set documented in Error Handling. If an error occurs during processing, the status will update to "error" and the error field will contain the specific failure reason.

Credit Cost

For Developer API requests, the cost depends entirely on the requested video duration.

Formula: Cost = DurationCredits

Duration	Credits per Video
4s	6
6s (Default)	9
8s	12