API reference

/fal-ai/veo3/image-to-video

Official document: https://fal.ai/models/fal-ai/veo3/image-to-video

POST/fal-ai/veo3/image-to-video

Body Parametersapplication/json

aspect_ratio string

Size, enumeration value: 16:9, 9:16, auto, default value: "auto"

duration string

Video duration, default value: "8s"

generate_audio boolean

Generate audio, default value: true

image_url* string

Reference image URL

prompt* string

prompt word

resolution string

Resolution, enumeration value: "720p", "1080p"

Responses

200 application/json

response-200 object

properties

cancel_url* string

Task cancellation URL

logs* array nullable

Run logs

metrics* object

Run metrics

queue_position* integer

Queue position

request_id* string

Request trace ID

response_url* string

Result query URL

status* string

Status

status_url* string

Status query URL

400 Bad request or validation failed application/json

response-400 object

properties

error* object

401 Missing or invalid API Key application/json

response-401 object

Request Body Example

2"aspect_ratio": "auto",

3"duration": "8s",

4"generate_audio": true,

5"image_url": "https://storage.googleapis.com/falserverless/example_inputs/veo3-i2v-input.png",

6"prompt": "A woman looks into the camera, breathes in, then exclaims energetically, \"have you guys checked out Veo3 Image-to-Video on Fal? It's incredible!\"",

7"resolution": "720p"

Code Sample cURL

1curl -X POST "https://api.digislash.com/fal-ai/veo3/image-to-video" \

2-H "Authorization: Bearer <API Key>" \

3-H "Content-Type: application/json" \

4-d '{

5"aspect_ratio": "auto",

6"duration": "8s",

7"generate_audio": true,

8"image_url": "https://storage.googleapis.com/falserverless/example_inputs/veo3-i2v-input.png",

9"prompt": "A woman looks into the camera, breathes in, then exclaims energetically, \"have you guys checked out Veo3 Image-to-Video on Fal? It's incredible!\"",

10"resolution": "720p"

11}'

Response

1▼{

2"cancel_url": "https://queue.fal.run/fal-ai/veo3/requests/bcd3b436-b7af-42f3-8649-204657bfaf10/cancel",

3"logs": [],

4"metrics": {},

5"queue_position": 0,

6"request_id": "bcd3b436-b7af-42f3-8649-204657bfaf10",

7"response_url": "https://queue.fal.run/fal-ai/veo3/requests/bcd3b436-b7af-42f3-8649-204657bfaf10",

8"status": "IN_QUEUE",

9"status_url": "https://queue.fal.run/fal-ai/veo3/requests/bcd3b436-b7af-42f3-8649-204657bfaf10/status"

10}