Create an Ecommerce Video workflow task

POST

/v1/ecommerce-video/tasks

Ecommerce Video requires product images and an explicit output duration.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/jsonRequired

Examples

Responses

🟢201

application/json

Task accepted

Bodyapplication/json

🟠402

🟠429

🟠400BadRequest

🟠401Unauthorized

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.beatapi.io/v1/ecommerce-video/tasks' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "images": [
        "https://cdn.example.com/product.png"
    ],
    "duration": 15,
    "prompt": "Fast product launch ad for paid social.",
    "aspect_ratio": "9:16"
}'

Response Example

201 - 成功示例

{
    "data": {
        "id": "task_p9Lm2",
        "object": "task",
        "workflow": "ecommerce-video",
        "status": "queued",
        "created_at": 1782210000,
        "updated_at": 1782210000,
        "output": null,
        "usage": {
            "credits_reserved": 225,
            "credits_settled": 0,
            "credits_refunded": 0
        },
        "request_id": "req_def456",
        "error_code": null,
        "error_message": null
    }
}

Modified at 2026-06-25 13:50:22

Create a Music Video workflow task

Poll task status