Basic image-to-video API

Animate a source image into a short low-cost video job for ads, reels, and product creative.

Price$7.998per request

MethodPOST

Route/v1/content/videos/image-to-video/basic-5s

StatusPlanned

MIME typeapplication/json

Rate limit4/minute

CacheNo cache

contentvideoimage-to-videoqueuefal

API URLhttps://x402.hexl.dev/v1/content/videos/image-to-video/basic-5s

Integration docs

Example request

{
  "prompt": "Slow camera push in with natural handheld motion",
  "imageUrl": "https://example.com/source.png",
  "aspectRatio": "9:16"
}

Example response

{
  "jobId": "eyJ2IjoxLCJyZXF1ZXN0SWQiOiJmYWwtcmVxdWVzdCJ9.signature",
  "status": "IN_QUEUE",
  "statusUrl": "/v1/content/jobs/eyJ2IjoxLCJyZXF1ZXN0SWQiOiJmYWwtcmVxdWVzdCJ9.signature",
  "resultUrl": "/v1/content/jobs/eyJ2IjoxLCJyZXF1ZXN0SWQiOiJmYWwtcmVxdWVzdCJ9.signature/result",
  "provider": "fal",
  "modelClass": "basic-video",
  "retailPrice": "$3.999/request"
}

Input schema

{
  "type": "object",
  "required": [
    "prompt",
    "imageUrl"
  ],
  "properties": {
    "prompt": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2000,
      "examples": [
        "Slow camera push in with natural handheld motion"
      ]
    },
    "imageUrl": {
      "type": "string",
      "format": "uri"
    },
    "aspectRatio": {
      "type": "string",
      "enum": [
        "16:9",
        "9:16",
        "1:1"
      ],
      "default": "9:16"
    },
    "duration": {
      "type": "number",
      "enum": [
        5
      ],
      "default": 5
    }
  }
}

Output schema

{
  "type": "object",
  "required": [
    "jobId",
    "status",
    "statusUrl",
    "resultUrl",
    "provider",
    "modelClass",
    "retailPrice"
  ],
  "properties": {
    "jobId": {
      "type": "string"
    },
    "status": {
      "type": "string"
    },
    "statusUrl": {
      "type": "string"
    },
    "resultUrl": {
      "type": "string"
    },
    "provider": {
      "type": "string"
    },
    "modelClass": {
      "type": "string"
    },
    "retailPrice": {
      "type": "string"
    }
  }
}