Veo3 Image to Video

POST

https://api.piapi.ai/api/v1/task

This is provided as Veo3 Video Text to Video API. available models:

veo3-video

veo3-video-fast

Pricing

Model	Generate Audio	Price
veo3-video	True	$0.24/s
veo3-video	False	$0.12/s
veo3-video-fast	True	$0.09/s
veo3-video-fast	False	$0.06/s

Request

Header Params

Body Params application/json

Example

{
    "model": "veo3",
    "task_type": "veo3-video-fast",
    "input": {
        "image_url": "https://storage.theapi.app/images/playground/20250916/oulb2qkbf0f.png",
        "prompt": "A medium shot, historical adventure setting: Warm lamplight illuminates a cartographer in a cluttered study, poring over an ancient, sprawling map spread across a large table. Cartographer: 'According to this old sea chart, the lost island isn't myth! We must prepare an expedition immediately!'",
        "aspect_ratio": "auto",
        "duration": "8s",
        "resolution": "720p",
        "generate_audio": true
    },
    "config": {
        "webhook_config": {
            "endpoint": "https://webhook.site/4cefe58d-d5b8-4694-b30a-9118747b9631",
            "secret": ""
        }
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.piapi.ai/api/v1/task' \
--header 'X-API-Key;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "veo3",
    "task_type": "veo3-video-fast",
    "input": {
        "image_url": "https://storage.theapi.app/images/playground/20250916/oulb2qkbf0f.png",
        "prompt": "A medium shot, historical adventure setting: Warm lamplight illuminates a cartographer in a cluttered study, poring over an ancient, sprawling map spread across a large table. Cartographer: '\''According to this old sea chart, the lost island isn'\''t myth! We must prepare an expedition immediately!'\''",
        "aspect_ratio": "auto",
        "duration": "8s",
        "resolution": "720p",
        "generate_audio": true
    },
    "config": {
        "webhook_config": {
            "endpoint": "https://webhook.site/4cefe58d-d5b8-4694-b30a-9118747b9631",
            "secret": ""
        }
    }
}'

Responses

🟢200Success

application/json

Body

Example

{
    "timestamp": 1758063316,
    "data": {
        "task_id": "a196da4b-b12d-48aa-bafc-e4eac4c3a357",
        "model": "veo3",
        "task_type": "veo3-video-fast",
        "status": "completed",
        "config": {
            "service_mode": "",
            "webhook_config": {
                "endpoint": "https://webhook.site/4cefe58d-d5b8-4694-b30a-9118747b9631",
                "secret": ""
            }
        },
        "input": {
            "aspect_ratio": "auto",
            "duration": "8s",
            "generate_audio": true,
            "image_url": "https://storage.theapi.app/images/playground/20250916/oulb2qkbf0f.png",
            "prompt": "A medium shot, historical adventure setting: Warm lamplight illuminates a cartographer in a cluttered study, poring over an ancient, sprawling map spread across a large table. Cartographer: 'According to this old sea chart, the lost island isn't myth! We must prepare an expedition immediately!'",
            "resolution": "720p"
        },
        "output": {
            "video": "https://img.theapi.app/ephemeral/45bed07d-d2ce-4b8e-82dc-d8a5ac053262.mp4"
        },
        "meta": {
            "created_at": "2025-09-16T22:54:11.744202577Z",
            "started_at": "2025-09-16T22:54:12.787320465Z",
            "ended_at": "2025-09-16T22:55:16.858440368Z",
            "usage": {
                "type": "llm",
                "frozen": 0,
                "consume": 12000000
            },
            "is_using_private_pool": false
        },
        "detail": null,
        "logs": [],
        "error": {
            "code": 0,
            "raw_message": "",
            "message": "",
            "detail": null
        }
    }
}

Modified at 2025-09-16 23:47:40

Veo3 Text to Video

Get task