BLblink
AI

Generate video

Generate video from text or an image using fal.ai. Billed per second of generated video under ai:video. Pass x-blink-agent-id for per-agent usage.

post/api/v1/ai/video

Request

  • Base URL
    https://core.blink.new
  • URL
    https://core.blink.new/api/v1/ai/video
  • Auth
    • HTTP bearer
    • or HTTP bearer

Request body

promptstring required

Prompt describing the desired video.

modelstring

Video model to use (defaults to fal-ai/veo3.1/fast)

durationstring

Desired video duration (model-dependent, e.g. "5s", "10s")

image_urlstring uri

Starting image for image-to-video generation (when supported by the model)

aspect_ratiostring

Aspect ratio of the output video (model-dependent)

Example request

{
  "prompt": "A time-lapse of a city skyline transitioning from day to night",
  "model": "fal-ai/veo3.1/fast",
  "duration": "5s",
  "image_url": "https://example.com/starting-frame.jpg",
  "aspect_ratio": "16:9"
}

Response

Video generated successfully

durationSecondsnumber

Duration of the generated video in seconds

Example response

{
  "result": {
    "video": {
      "url": "https://fal.media/files/rabbit/abc123.mp4",
      "content_type": "video/mp4"
    }
  },
  "metadata": {
    "model": "fal-ai/veo3.1/fast",
    "provider": "fal-ai"
  },
  "durationSeconds": 5
}

Changes

No recorded changes to this operation across all 1 revision of this API.