Get Shot Media

POST

/v1/music-video/tasks/{task_id}/shots/{shot_id}/media

Materialize one storyboard shot video using its BeatAPI shot_id.
If the shot has not been stored yet, BeatAPI retrieves the current shot
video, stores it under BeatAPI media storage, and returns a BeatAPI media
URL. Repeated calls return the stored URL when available.

This endpoint does not edit the shot and does not compose a new final
Music Video.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Path Params

Responses

🟢200

application/json

Shot media URL

Bodyapplication/json

🟠404

🟠400BadRequest

🟠401Unauthorized

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.beatapi.io/v1/music-video/tasks/task_8K2qA/shots/shot_xxx/media' \
--header 'Authorization: Bearer <token>'

Response Example

200 - 成功示例

{
    "data": {
        "object": "shot_media",
        "task_id": "task_8K2qA",
        "shot_id": "shot_xxx",
        "index": 0,
        "status": "succeeded",
        "media": {
            "type": "video",
            "url": "https://media.beatapi.io/outputs/task_8K2qA/shots/shot_xxx/current.mp4",
            "mime_type": "video/mp4"
        },
        "created_at": 1782210000,
        "updated_at": 1782210300,
        "request_id": "req_abc123"
    }
}

Modified at 2026-07-31 15:10:04

Edit Shot

Compose Video