Actions / Video Studio
Start video edit
Read and createstart_video_edit
Starts a Video Studio edit from one or more Media Library videos (ids from list_media), in a shape: 9:16, 16:9, 1:1 or 4:5. Chirpy prepares a preview copy and writes the script, which takes a minute or two; get_video_edit shows when it is ready.
Needs the write scope. Creates or changes things in Chirpy. Publishes nothing.
Inputs
| Input | Type | Required | Description |
|---|---|---|---|
mediaFileIds | integer[] | Yes | Up to 10. |
shape | "9:16" | "16:9" | "1:1" | "4:5" | Yes | |
title | string |
REST
curl https://chirpy.me/api/v1/start_video_edit \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{"mediaFileIds":[123],"shape":"9:16"}'MCP
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "start_video_edit",
"arguments": {
"mediaFileIds": [
123
],
"shape": "9:16"
}
}
}MCP hints: readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false.
