Create Task

POST

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

This endpoint from PiAPI's Dream Machine API utilizes Dream Machine model by Luma Labs to produce text/image-to-video generation.

Pricing

$0.2 for 5s video

$0.4 for 9s video

Note

Luma no longer supports model Ray1.

Currently only model Ray2 is supported in GoAPI, Ray3 is in development.

Input/output structure updated on 2026/02/16.

Request

Header Params

Body Params application/json

Example

{
    "model": "luma",
    "task_type": "video_generation",
    "input": {
        "model": "ray-v2",
        "prompt": "A cinematic anime character intimate closeup, she is sitting at a cafe on a busy city street in the morning, drinking coffee, it is cold, a dynamic scene",
        "duration": 5,
        "aspect_ratio": "16:9",
        "start_image": "https://i.ibb.co/wbw9GLY/girl.webp",
        "end_image": "https://i.ibb.co/wbw9GLY/girl.webp",
        "loop": false
    },
    "config": {
        "webhook_config": {
            "endpoint": "https://webhook.site/64e7e8fa-a47a-4d30-b00a-8746d2d04590",
            "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": "luma",
    "task_type": "video_generation",
    "input": {
        "model": "ray-v2",
        "prompt": "A cinematic anime character intimate closeup, she is sitting at a cafe on a busy city street in the morning, drinking coffee, it is cold, a dynamic scene",
        "duration": 5,
        "aspect_ratio": "16:9",
        "start_image": "https://i.ibb.co/wbw9GLY/girl.webp",
        "end_image": "https://i.ibb.co/wbw9GLY/girl.webp",
        "loop": false
    },
    "config": {
        "webhook_config": {
            "endpoint": "https://webhook.site/64e7e8fa-a47a-4d30-b00a-8746d2d04590",
            "secret": ""
        }
    }
}'

Responses

🟢200Success

application/json

Body

Example

{
    "code": 200,
    "data": {
        "task_id": "c42f6ec7-36cd-45a3-981c-826b6d101f58",
        "model": "luma",
        "task_type": "video_generation",
        "status": "pending",
        "config": {
            "service_mode": "",
            "webhook_config": {
                "endpoint": "https://webhook.site/64e7e8fa-a47a-4d30-b00a-8746d2d04590",
                "secret": ""
            }
        },
        "input": {
            "model": "ray-v2",
            "prompt": "A cinematic anime character intimate closeup, she is sitting at a cafe on a busy city street in the morning, drinking coffee, it is cold, a dynamic scene",
            "start_image": "https://i.ibb.co/wbw9GLY/girl.webp",
            "end_image": "https://i.ibb.co/wbw9GLY/girl.webp",
            "duration": 5,
            "aspect_ratio": "16:9",
            "loop": false
        },
        "output": null,
        "meta": {
            "created_at": "2026-02-16T14:29:38.908991334Z",
            "started_at": "0001-01-01T00:00:00Z",
            "ended_at": "0001-01-01T00:00:00Z",
            "usage": {
                "type": "llm",
                "frozen": 0,
                "consume": 2000000
            },
            "is_using_private_pool": false
        },
        "detail": null,
        "logs": [],
        "error": {
            "code": 0,
            "raw_message": "",
            "message": "",
            "detail": null
        }
    },
    "message": "success"
}

Modified at 2026-02-16 14:46:44

Generate Video

Get Task