Create a Music Video workflow task

POST

/v1/music-video/tasks

Music Video requires public HTTPS image URLs, a public HTTPS audio URL,
a prompt, and an explicit output language. It returns a task id
immediately; poll the task or receive webhook events for completion.

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/music-video/tasks' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "images": [
        "https://cdn.example.com/singer-reference.png"
    ],
    "audio_url": "https://cdn.example.com/song-preview.mp3",
    "prompt": "Neon rooftop performance with metro cutaways and cinematic light trails.",
    "language": "en",
    "resolution": "720p"
}'

Response Example

201 - 成功示例

{
    "data": {
        "id": "task_8K2qA",
        "object": "task",
        "workflow": "music-video",
        "status": "queued",
        "created_at": 1782210000,
        "updated_at": 1782210000,
        "output": null,
        "usage": {
            "credits_reserved": 450,
            "credits_settled": 0,
            "credits_refunded": 0
        },
        "request_id": "req_abc123",
        "error_code": null,
        "error_message": null
    }
}

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

List launch workflows

Create an Ecommerce Video workflow task