BeatAPICoreMusic Video

Edit a Music Video storyboard shot

Edit one storyboard shot using its BeatAPI `shot_id`. This operation charges the customer USD balance using the applicable task tier and shot duration. Standard edits accept only `prompt`. Premium edits accept `prompt` plus up to 6 optional replacement `images`. Generation quality, resolution, and shot duration are inherited from the original task and are not editable request fields. When the edit finishes, BeatAPI stores the edited shot media and exposes it on that shot. The existing final Music Video is not replaced until you call compose with the selected shot ids.

身份验证

AuthorizationBearer

Send your API key as Authorization: Bearer <BEATAPI_API_KEY>.

路径参数

task_idstring必需
shot_idstring必需

请求头

Idempotency-Keystring可选

Optional retry key. Reusing the same key for this task, shot, and request body returns the accepted task without charging the USD amount again; changing any of them returns 409 idempotency_conflict.

请求

This endpoint expects an object.
promptstring必需<=3000 characters
imageslist of strings可选

Premium tasks only. Optional replacement scene images; an empty array is treated as omitted. Standard tasks reject this field.

响应

Shot edit accepted
dataobject
Accepted or current BeatAPI task state.

错误

400
Bad Request Error
401
Unauthorized Error
402
Payment Required Error
404
Not Found Error
409
Conflict Error
429
Too Many Requests Error
500
Internal Server Error
502
Bad Gateway Error