BlitzReels Video Editor

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "number",
      "description": "Maximum number of projects to return (1-50)",
      "default": 10,
      "minimum": 1,
      "maximum": 50
    },
    "offset": {
      "type": "number",
      "description": "Project offset.",
      "default": 0,
      "minimum": 0
    },
    "status": {
      "type": "string",
      "enum": [
        "active",
        "archived",
        "all"
      ],
      "description": "Filter by project status",
      "default": "active"
    },
    "search": {
      "type": "string",
      "description": "Search projects by name"
    },
    "workspaceId": {
      "type": "string",
      "description": "Optional workspace ID. Defaults to the user's default workspace. UUID string.",
      "format": "uuid"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "description": "The project ID to get details for. UUID string.",
      "format": "uuid"
    }
  },
  "required": [
    "projectId"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "description": "Project UUID. UUID string.",
      "format": "uuid"
    },
    "mode": {
      "type": "string",
      "enum": [
        "summary",
        "assets",
        "timeline",
        "transcript",
        "full"
      ],
      "description": "Bounded project context view to return.",
      "default": "timeline"
    },
    "search": {
      "type": "string",
      "description": "Optional media search when mode is assets or full."
    },
    "assetLimit": {
      "type": "integer",
      "description": "Maximum media assets to return (1-50).",
      "minimum": 1,
      "maximum": 50
    },
    "assetOffset": {
      "type": "integer",
      "description": "Media asset offset.",
      "minimum": 0
    },
    "timelineLimit": {
      "type": "integer",
      "description": "Maximum timeline items to return (1-1000).",
      "minimum": 1,
      "maximum": 1000
    },
    "timelineOffset": {
      "type": "integer",
      "description": "Timeline item offset.",
      "minimum": 0
    },
    "transcriptLimit": {
      "type": "integer",
      "description": "Maximum transcript segments to return (1-500).",
      "minimum": 1,
      "maximum": 500
    },
    "transcriptOffset": {
      "type": "integer",
      "description": "Transcript segment offset.",
      "minimum": 0
    },
    "captionWordLimit": {
      "type": "integer",
      "description": "Maximum caption words to return (1-2000).",
      "minimum": 1,
      "maximum": 2000
    },
    "captionWordOffset": {
      "type": "integer",
      "description": "Caption word offset.",
      "minimum": 0
    }
  },
  "required": [
    "projectId"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "description": "Filter exports by project ID. UUID string.",
      "format": "uuid"
    },
    "exportId": {
      "type": "string",
      "description": "Return only this export, including its signed download URL when the render is complete. UUID string.",
      "format": "uuid"
    },
    "limit": {
      "type": "number",
      "description": "Maximum exports to return when exportId is absent (1-50).",
      "default": 20,
      "minimum": 1,
      "maximum": 50
    },
    "offset": {
      "type": "number",
      "description": "Export offset when exportId is absent.",
      "default": 0,
      "minimum": 0
    },
    "workspaceId": {
      "type": "string",
      "description": "Optional workspace ID when projectId is not provided. Defaults to the user's default workspace. UUID string.",
      "format": "uuid"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "assetType": {
      "type": "string",
      "enum": [
        "video",
        "audio",
        "image",
        "all"
      ],
      "description": "Filter by asset type",
      "default": "all"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "description": "Maximum number of assets to return (1-50)",
      "default": 20
    },
    "offset": {
      "type": "integer",
      "minimum": 0,
      "description": "Media asset offset.",
      "default": 0
    },
    "workspaceId": {
      "type": "string",
      "description": "Optional workspace ID. Defaults to the user's default workspace. UUID string.",
      "format": "uuid"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "assetId": {
      "type": "string",
      "description": "The media asset ID to get transcript for. UUID string.",
      "format": "uuid"
    },
    "mode": {
      "type": "string",
      "enum": [
        "summary",
        "text",
        "full"
      ],
      "description": "Summary returns metadata only. Text returns joined text for a bounded segment window. Full returns the bounded segment objects without duplicating their text.",
      "default": "summary"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 200,
      "description": "Maximum transcript segments to return (1-200).",
      "default": 50
    },
    "offset": {
      "type": "integer",
      "minimum": 0,
      "description": "Transcript segment offset.",
      "default": 0
    }
  },
  "required": [
    "assetId"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Project name (1-100 characters)"
    },
    "description": {
      "type": "string",
      "description": "Project description (optional, max 500 characters)"
    },
    "aspectRatio": {
      "type": "string",
      "enum": [
        "16:9",
        "9:16",
        "1:1"
      ],
      "description": "Video aspect ratio",
      "default": "9:16"
    },
    "frameRate": {
      "type": "string",
      "enum": [
        "24",
        "25",
        "30",
        "50",
        "60"
      ],
      "description": "Video frame rate",
      "default": "30"
    },
    "workspaceId": {
      "type": "string",
      "description": "Optional workspace ID. Defaults to the user's default workspace. UUID string.",
      "format": "uuid"
    },
    "idempotencyKey": {
      "type": "string",
      "description": "Retry key. Reuse only with identical inputs."
    }
  },
  "required": [
    "name"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "file": {
      "type": "object",
      "description": "A file from ChatGPT: attached by the user, picked from their file library, or produced earlier in this conversation. ChatGPT provides this value.",
      "properties": {
        "download_url": {
          "type": "string",
          "format": "uri"
        },
        "file_id": {
          "type": "string"
        },
        "file_name": {
          "type": "string"
        },
        "mime_type": {
          "type": "string"
        }
      },
      "required": [
        "download_url",
        "file_id"
      ]
    },
    "name": {
      "type": "string",
      "description": "Optional name to use in BlitzReels."
    },
    "projectId": {
      "type": "string",
      "description": "Optional BlitzReels project ID to associate with the uploaded file. UUID string.",
      "format": "uuid"
    },
    "workspaceId": {
      "type": "string",
      "description": "Optional workspace ID when projectId is not provided. Defaults to the user's default workspace. UUID string.",
      "format": "uuid"
    }
  },
  "required": [
    "file"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "URL of the media file to download and upload",
      "format": "uri"
    },
    "name": {
      "type": "string",
      "description": "Optional name for the file"
    },
    "projectId": {
      "type": "string",
      "description": "Optional project ID to associate the upload with. UUID string.",
      "format": "uuid"
    },
    "workspaceId": {
      "type": "string",
      "description": "Optional workspace ID when projectId is not provided. Defaults to the user's default workspace. UUID string.",
      "format": "uuid"
    },
    "contentHashSha256": {
      "type": "string",
      "description": "Optional SHA-256 hex hash of file bytes for dedupe optimization. 64-character hex string.",
      "pattern": "^[a-fA-F0-9]{64}$"
    }
  },
  "required": [
    "url"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "fileName": {
      "type": "string",
      "description": "Name of the file to upload"
    },
    "contentType": {
      "type": "string",
      "description": "MIME type (e.g., video/mp4, audio/mp3, image/jpeg)"
    },
    "projectId": {
      "type": "string",
      "description": "Optional project ID to associate the upload with. UUID string.",
      "format": "uuid"
    },
    "workspaceId": {
      "type": "string",
      "description": "Optional workspace ID when projectId is not provided. Defaults to the user's default workspace. UUID string.",
      "format": "uuid"
    }
  },
  "required": [
    "fileName",
    "contentType"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "storageKey": {
      "type": "string",
      "description": "Storage key returned from media_upload_start"
    },
    "fileName": {
      "type": "string",
      "description": "Name of the uploaded file"
    },
    "contentType": {
      "type": "string",
      "description": "MIME type of the file"
    },
    "fileSizeBytes": {
      "type": "number",
      "description": "Size of the uploaded file in bytes",
      "minimum": 1
    },
    "contentHashSha256": {
      "type": "string",
      "description": "Optional SHA-256 hex hash of file bytes for dedupe optimization. 64-character hex string.",
      "pattern": "^[a-fA-F0-9]{64}$"
    },
    "projectId": {
      "type": "string",
      "description": "Optional project ID to associate the upload with. UUID string.",
      "format": "uuid"
    },
    "workspaceId": {
      "type": "string",
      "description": "Optional workspace ID when projectId is not provided. Defaults to the user's default workspace. UUID string.",
      "format": "uuid"
    }
  },
  "required": [
    "storageKey",
    "fileName",
    "contentType",
    "fileSizeBytes"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "Public video URL. Supports social video links and Google Drive file links.",
      "format": "uri"
    }
  },
  "required": [
    "url"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "Video page URL or direct media URL to inspect for an importable video.",
      "format": "uri"
    }
  },
  "required": [
    "url"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "workspaceId": {
      "type": "string",
      "description": "Optional workspace ID. Defaults to the user's default workspace. UUID string.",
      "format": "uuid"
    },
    "includeBuiltInLooks": {
      "type": "boolean",
      "description": "Include built-in caption looks.",
      "default": true
    },
    "includeSavedThemes": {
      "type": "boolean",
      "description": "Include saved workspace caption themes.",
      "default": true
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "assetId": {
      "type": "string",
      "description": "Media asset UUID. UUID string.",
      "format": "uuid"
    }
  },
  "required": [
    "assetId"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "assetId": {
      "type": "string",
      "description": "Media asset UUID. UUID string.",
      "format": "uuid"
    },
    "maxDimension": {
      "type": "integer",
      "description": "Maximum preview width or height in pixels (256-1536).",
      "minimum": 256,
      "maximum": 1536,
      "default": 1024
    }
  },
  "required": [
    "assetId"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "workspaceId": {
      "type": "string",
      "description": "Workspace UUID, or null for the default workspace. UUID string.",
      "format": "uuid"
    },
    "parentFolderId": {
      "type": "string",
      "format": "uuid",
      "description": "Parent folder UUID, or null for root folders."
    },
    "limit": {
      "type": "integer",
      "description": "Maximum folders to return (1-50).",
      "minimum": 1,
      "maximum": 50,
      "default": 20
    },
    "offset": {
      "type": "integer",
      "description": "Folder offset.",
      "minimum": 0,
      "default": 0
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Folder name.",
      "minLength": 1,
      "maxLength": 255
    },
    "parentFolderId": {
      "type": "string",
      "format": "uuid",
      "description": "Parent folder UUID, or null for the root."
    },
    "description": {
      "type": "string",
      "description": "Optional folder description.",
      "maxLength": 1000
    },
    "iconType": {
      "type": "string",
      "enum": [
        "folder",
        "code",
        "video",
        "audio",
        "image",
        "document",
        "star",
        "spark"
      ],
      "description": "Folder icon type.",
      "default": "folder"
    },
    "workspaceId": {
      "type": "string",
      "description": "Workspace UUID, or null for the default workspace. UUID string.",
      "format": "uuid"
    },
    "idempotencyKey": {
      "type": "string",
      "description": "Retry key. Reuse only with identical inputs."
    }
  },
  "required": [
    "name"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "assetId": {
      "type": "string",
      "description": "Media asset UUID. UUID string.",
      "format": "uuid"
    },
    "name": {
      "type": "string",
      "description": "New media asset name.",
      "minLength": 1,
      "maxLength": 255
    },
    "description": {
      "type": "string",
      "description": "New description, or null to clear it.",
      "maxLength": 5000
    },
    "folderId": {
      "type": "string",
      "format": "uuid",
      "description": "Target folder UUID, or null to move the asset to root."
    },
    "allowUsingAsBroll": {
      "type": "boolean",
      "description": "Whether the asset may be selected as B-roll."
    },
    "idempotencyKey": {
      "type": "string",
      "description": "Retry key. Reuse only with identical inputs."
    }
  },
  "required": [
    "assetId"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "assetId": {
      "type": "string",
      "description": "Existing BlitzReels video asset ID. Provide assetId or url, not both. UUID string.",
      "format": "uuid"
    },
    "url": {
      "type": "string",
      "description": "Video URL to import before clipping. Supports social video links, Google Drive file links, and direct video file URLs.",
      "format": "uri"
    },
    "workspaceId": {
      "type": "string",
      "description": "Optional workspace ID. Defaults to the user's default workspace. UUID string.",
      "format": "uuid"
    },
    "clipPresetId": {
      "type": "string",
      "enum": [
        "default",
        "high-retention",
        "demo-focus"
      ],
      "description": "Clip style preset. Use high-retention for High Retention clips or demo-focus for product and screen demos.",
      "default": "default"
    },
    "createSharePage": {
      "type": "boolean",
      "description": "Create a public showcase page where completed clips appear.",
      "default": false
    },
    "autoTrimSilence": {
      "type": "boolean",
      "description": "Trim silence around selected moments.",
      "default": true
    },
    "captionThemeId": {
      "type": "string",
      "description": "Optional saved caption theme ID. Null uses workspace default captions. UUID string.",
      "format": "uuid"
    },
    "idempotencyKey": {
      "type": "string",
      "description": "Retry key. Reuse only with identical inputs."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "batchId": {
      "type": "string",
      "description": "Clip batch ID returned from clips_create. UUID string.",
      "format": "uuid"
    },
    "workspaceId": {
      "type": "string",
      "description": "Optional workspace ID. Defaults to the user's default workspace. UUID string.",
      "format": "uuid"
    }
  },
  "required": [
    "batchId"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "operation": {
      "type": "string",
      "enum": [
        "list",
        "get",
        "reselect",
        "repair",
        "export",
        "list_caption_words",
        "set_caption_look"
      ]
    },
    "workspaceId": {
      "type": "string",
      "format": "uuid",
      "description": "UUID string."
    },
    "clipId": {
      "type": "string"
    },
    "projectId": {
      "type": "string",
      "format": "uuid",
      "description": "UUID string."
    },
    "assetId": {
      "type": "string",
      "format": "uuid",
      "description": "UUID string."
    },
    "status": {
      "type": "string"
    },
    "limit": {
      "type": "number",
      "minimum": 1,
      "maximum": 50,
      "default": 20
    },
    "offset": {
      "type": "number",
      "minimum": 0,
      "default": 0
    },
    "selectionMode": {
      "type": "string",
      "enum": [
        "auto_best",
        "suggestion",
        "time_range"
      ]
    },
    "suggestionId": {
      "type": "string",
      "format": "uuid",
      "description": "UUID string."
    },
    "startSeconds": {
      "type": "number",
      "minimum": 0
    },
    "endSeconds": {
      "type": "number"
    },
    "minDurationSeconds": {
      "type": "number"
    },
    "maxDurationSeconds": {
      "type": "number"
    },
    "repairMode": {
      "type": "string",
      "enum": [
        "auto",
        "prefer_split",
        "prefer_focus",
        "prefer_tutorial",
        "prefer_demo",
        "move_captions_off_faces"
      ],
      "default": "auto"
    },
    "resolution": {
      "type": "string",
      "enum": [
        "720p",
        "1080p"
      ],
      "default": "1080p"
    },
    "format": {
      "type": "string",
      "enum": [
        "mp4",
        "mov"
      ],
      "default": "mp4"
    },
    "coverFrameSeconds": {
      "type": "number",
      "minimum": 0
    },
    "allowBlockingQaBypass": {
      "type": "boolean",
      "default": false
    },
    "timelineItemId": {
      "type": "string"
    },
    "matchText": {
      "type": "string"
    },
    "captionWordLimit": {
      "type": "number",
      "minimum": 1,
      "maximum": 500,
      "default": 100
    },
    "lookId": {
      "type": "string"
    },
    "clearWordOverrides": {
      "type": "boolean",
      "default": false
    }
  },
  "required": [
    "operation"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "workspaceId": {
      "type": "string",
      "format": "uuid",
      "description": "UUID string."
    },
    "batchId": {
      "type": "string",
      "format": "uuid",
      "description": "UUID string."
    },
    "retention": {
      "type": "string",
      "enum": [
        "retain_projects_and_exports",
        "delete_projects_and_exports"
      ],
      "default": "retain_projects_and_exports"
    },
    "dryRun": {
      "type": "boolean",
      "default": true
    },
    "confirmDelete": {
      "type": "boolean",
      "default": false
    },
    "idempotencyKey": {
      "type": "string",
      "minLength": 8,
      "maxLength": 255
    }
  },
  "required": [
    "batchId",
    "idempotencyKey"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "format": "uuid",
      "description": "UUID string."
    },
    "operation": {
      "oneOf": [
        {
          "type": "object",
          "properties": {
            "operationId": {
              "type": "string",
              "const": "timeline.item.trim"
            },
            "timelineItemId": {
              "type": "string",
              "format": "uuid"
            },
            "trimStartDeltaSeconds": {
              "type": "number"
            },
            "trimEndDeltaSeconds": {
              "type": "number"
            },
            "snapToFrame": {
              "type": "boolean"
            }
          },
          "required": [
            "operationId",
            "timelineItemId",
            "trimStartDeltaSeconds",
            "trimEndDeltaSeconds",
            "snapToFrame"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "operationId": {
              "type": "string",
              "const": "timeline.item.split"
            },
            "timelineItemId": {
              "type": "string",
              "format": "uuid"
            },
            "splitAtSeconds": {
              "type": "number",
              "minimum": 0
            },
            "snapToFrame": {
              "type": "boolean"
            }
          },
          "required": [
            "operationId",
            "timelineItemId",
            "splitAtSeconds",
            "snapToFrame"
          ],
          "additionalProperties": false
        }
      ]
    },
    "expectedRevision": {
      "type": [
        "integer",
        "null"
      ],
      "minimum": 0,
      "description": "Expected sequence revision, or null."
    },
    "idempotencyKey": {
      "type": "string",
      "minLength": 8,
      "maxLength": 200,
      "pattern": "^[A-Za-z0-9._:-]+$"
    }
  },
  "required": [
    "projectId",
    "operation",
    "expectedRevision",
    "idempotencyKey"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "format": "uuid",
      "description": "UUID string."
    },
    "operation": {
      "oneOf": [
        {
          "type": "object",
          "properties": {
            "operationId": {
              "type": "string",
              "const": "timeline.item.trim"
            },
            "timelineItemId": {
              "type": "string",
              "format": "uuid"
            },
            "trimStartDeltaSeconds": {
              "type": "number"
            },
            "trimEndDeltaSeconds": {
              "type": "number"
            },
            "snapToFrame": {
              "type": "boolean"
            }
          },
          "required": [
            "operationId",
            "timelineItemId",
            "trimStartDeltaSeconds",
            "trimEndDeltaSeconds",
            "snapToFrame"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "operationId": {
              "type": "string",
              "const": "timeline.item.split"
            },
            "timelineItemId": {
              "type": "string",
              "format": "uuid"
            },
            "splitAtSeconds": {
              "type": "number",
              "minimum": 0
            },
            "snapToFrame": {
              "type": "boolean"
            }
          },
          "required": [
            "operationId",
            "timelineItemId",
            "splitAtSeconds",
            "snapToFrame"
          ],
          "additionalProperties": false
        }
      ]
    },
    "expectedRevision": {
      "type": [
        "integer",
        "null"
      ],
      "minimum": 0,
      "description": "Expected sequence revision, or null."
    }
  },
  "required": [
    "projectId",
    "operation",
    "expectedRevision"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "format": "uuid",
      "description": "UUID string."
    },
    "timelineItemId": {
      "type": "string",
      "format": "uuid"
    },
    "startSeconds": {
      "type": "number",
      "minimum": 0
    },
    "durationSeconds": {
      "type": "number",
      "exclusiveMinimum": 0,
      "minimum": 0
    },
    "trimStartSeconds": {
      "type": "number",
      "minimum": 0
    },
    "trimEndSeconds": {
      "type": "number",
      "minimum": 0
    },
    "layerIndex": {
      "type": "integer",
      "minimum": 0
    },
    "ignored": {
      "type": "boolean"
    },
    "blurredBackground": {
      "type": "boolean"
    },
    "expectedRevision": {
      "type": "integer",
      "minimum": 0,
      "description": "Expected sequence revision, or null."
    },
    "idempotencyKey": {
      "type": "string",
      "minLength": 8,
      "maxLength": 200,
      "pattern": "^[A-Za-z0-9._:-]+$",
      "description": "Retry key. Reuse only with identical inputs."
    }
  },
  "required": [
    "projectId",
    "timelineItemId",
    "idempotencyKey"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "format": "uuid",
      "description": "UUID string."
    },
    "updates": {
      "type": "array",
      "minItems": 1,
      "maxItems": 100,
      "description": "Each update needs at least one field to change besides timelineItemId.",
      "items": {
        "type": "object",
        "properties": {
          "timelineItemId": {
            "type": "string",
            "format": "uuid"
          },
          "startSeconds": {
            "type": "number",
            "minimum": 0
          },
          "durationSeconds": {
            "type": "number",
            "exclusiveMinimum": 0
          },
          "trimStartSeconds": {
            "type": "number",
            "minimum": 0
          },
          "trimEndSeconds": {
            "type": "number",
            "minimum": 0
          },
          "layerIndex": {
            "type": "integer",
            "minimum": 0
          },
          "ignored": {
            "type": "boolean"
          },
          "blurredBackground": {
            "type": "boolean"
          }
        },
        "required": [
          "timelineItemId"
        ],
        "additionalProperties": false
      }
    },
    "expectedRevision": {
      "type": "integer",
      "minimum": 0,
      "description": "Expected sequence revision, or null."
    },
    "idempotencyKey": {
      "type": "string",
      "minLength": 8,
      "maxLength": 200,
      "pattern": "^[A-Za-z0-9._:-]+$",
      "description": "Retry key. Reuse only with identical inputs."
    }
  },
  "required": [
    "projectId",
    "updates",
    "idempotencyKey"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "format": "uuid",
      "description": "UUID string."
    },
    "timelineItemId": {
      "type": "string",
      "format": "uuid"
    },
    "expectedRevision": {
      "type": "integer",
      "minimum": 0,
      "description": "Expected sequence revision, or null."
    },
    "idempotencyKey": {
      "type": "string",
      "minLength": 8,
      "maxLength": 200,
      "pattern": "^[A-Za-z0-9._:-]+$",
      "description": "Retry key. Reuse only with identical inputs."
    }
  },
  "required": [
    "projectId",
    "timelineItemId",
    "idempotencyKey"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "format": "uuid",
      "description": "UUID string."
    },
    "timelineItemIds": {
      "type": "array",
      "minItems": 1,
      "maxItems": 100,
      "items": {
        "type": "string",
        "format": "uuid"
      }
    },
    "removeAssociatedCaptions": {
      "type": "boolean",
      "default": true
    },
    "dryRun": {
      "type": "boolean",
      "default": true
    },
    "confirmDelete": {
      "type": "boolean",
      "default": false
    },
    "expectedRevision": {
      "type": "integer",
      "minimum": 0,
      "description": "Expected sequence revision, or null."
    },
    "idempotencyKey": {
      "type": "string",
      "minLength": 8,
      "maxLength": 200,
      "pattern": "^[A-Za-z0-9._:-]+$"
    }
  },
  "required": [
    "projectId",
    "timelineItemIds"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "format": "uuid",
      "description": "UUID string."
    },
    "text": {
      "type": "string",
      "minLength": 1,
      "maxLength": 500
    },
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 255
    },
    "startSeconds": {
      "type": "number",
      "minimum": 0,
      "default": 0
    },
    "durationSeconds": {
      "type": "number",
      "exclusiveMinimum": 0,
      "maximum": 3600,
      "default": 4,
      "minimum": 0
    },
    "layerIndex": {
      "type": "integer",
      "minimum": 0
    },
    "expectedRevision": {
      "type": "integer",
      "minimum": 0,
      "description": "Expected sequence revision, or null."
    },
    "idempotencyKey": {
      "type": "string",
      "minLength": 8,
      "maxLength": 200,
      "pattern": "^[A-Za-z0-9._:-]+$",
      "description": "Retry key. Reuse only with identical inputs."
    }
  },
  "required": [
    "projectId",
    "text",
    "idempotencyKey"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "format": "uuid",
      "description": "UUID string."
    },
    "timelineItemId": {
      "type": "string",
      "format": "uuid"
    },
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 255
    },
    "startSeconds": {
      "type": "number",
      "minimum": 0
    },
    "durationSeconds": {
      "type": "number",
      "exclusiveMinimum": 0,
      "maximum": 10,
      "default": 0.6,
      "minimum": 0
    },
    "easing": {
      "type": "string",
      "enum": [
        "linear",
        "easeIn",
        "easeOut",
        "easeInOut"
      ],
      "default": "easeInOut"
    },
    "layerIndex": {
      "type": "integer",
      "minimum": 0
    },
    "preset": {
      "type": "string",
      "enum": [
        "flash",
        "whip-left",
        "whip-right",
        "zoom-punch",
        "glitch"
      ],
      "default": "flash"
    },
    "intensity": {
      "type": "number",
      "minimum": 0.2,
      "maximum": 2,
      "default": 0.5
    },
    "includeSfx": {
      "type": "boolean",
      "default": false
    },
    "expectedRevision": {
      "type": "integer",
      "minimum": 0,
      "description": "Expected sequence revision, or null."
    },
    "idempotencyKey": {
      "type": "string",
      "minLength": 8,
      "maxLength": 200,
      "pattern": "^[A-Za-z0-9._:-]+$",
      "description": "Retry key. Reuse only with identical inputs."
    }
  },
  "required": [
    "projectId",
    "startSeconds",
    "idempotencyKey"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "search": {
      "type": "string",
      "description": "Optional search query for workflow name or description."
    },
    "trigger": {
      "type": "string",
      "enum": [
        "video_uploaded",
        "project_created",
        "export_started",
        "manual"
      ],
      "description": "Optional trigger filter."
    },
    "limit": {
      "type": "number",
      "description": "Maximum workflows to return (1-50).",
      "default": 20,
      "minimum": 1,
      "maximum": 50
    },
    "offset": {
      "type": "number",
      "description": "Pagination offset.",
      "default": 0,
      "minimum": 0
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "workflowId": {
      "type": "string",
      "description": "Public workflow ID to import. UUID string.",
      "format": "uuid"
    },
    "workspaceId": {
      "type": "string",
      "description": "Optional target workspace ID. Defaults to the user's default workspace. UUID string.",
      "format": "uuid"
    }
  },
  "required": [
    "workflowId"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "workflowId": {
      "type": "string",
      "description": "Workflow ID. UUID string.",
      "format": "uuid"
    },
    "stepLimit": {
      "type": "number",
      "description": "Maximum workflow steps to return (1-100).",
      "default": 20
    },
    "stepOffset": {
      "type": "number",
      "description": "Workflow step offset.",
      "default": 0
    }
  },
  "required": [
    "workflowId"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "workflowId": {
      "type": "string",
      "description": "Workflow ID to run. UUID string.",
      "format": "uuid"
    },
    "inputs": {
      "type": "object",
      "description": "Optional workflow input values. Omit to use workflow defaults.",
      "additionalProperties": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "number"
          },
          {
            "type": "boolean"
          },
          {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          {
            "type": "object",
            "additionalProperties": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "number"
                },
                {
                  "type": "boolean"
                },
                {
                  "type": "null"
                }
              ]
            }
          },
          {
            "type": "null"
          }
        ]
      },
      "default": {}
    },
    "projectId": {
      "type": "string",
      "description": "Optional project ID for workflows that operate on an existing project. UUID string.",
      "format": "uuid"
    }
  },
  "required": [
    "workflowId"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "runId": {
      "type": "string",
      "description": "Workflow run ID. UUID string.",
      "format": "uuid"
    },
    "stepLimit": {
      "type": "number",
      "description": "Maximum workflow run steps to return (1-100).",
      "default": 20
    },
    "stepOffset": {
      "type": "number",
      "description": "Workflow run step offset.",
      "default": 0
    }
  },
  "required": [
    "runId"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "runId": {
      "type": "string",
      "description": "Workflow run ID. UUID string.",
      "format": "uuid"
    },
    "stepRunId": {
      "type": "string",
      "description": "Step run ID from workflow_runs_create or workflow_runs_get. UUID string.",
      "format": "uuid"
    }
  },
  "required": [
    "runId",
    "stepRunId"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "description": "BlitzReels project ID. UUID string.",
      "format": "uuid"
    },
    "assetId": {
      "type": "string",
      "description": "Image or video media asset ID. UUID string.",
      "format": "uuid"
    },
    "startSeconds": {
      "type": "number",
      "description": "Timeline start time in seconds",
      "default": 0,
      "minimum": 0
    },
    "durationSeconds": {
      "type": "number",
      "description": "Duration in seconds. Required for still images when a specific length is needed.",
      "minimum": 0
    },
    "positionPreset": {
      "type": "string",
      "enum": [
        "center",
        "fullscreen",
        "pip-top-left",
        "pip-top-right",
        "pip-bottom-left",
        "pip-bottom-right"
      ],
      "description": "Visual placement preset",
      "default": "fullscreen"
    },
    "animationPreset": {
      "type": "string",
      "enum": [
        "none",
        "fadeIn",
        "fadeOut",
        "zoomIn",
        "zoomOut",
        "slideLeft",
        "slideRight",
        "slideUp",
        "slideDown",
        "popIn",
        "bounce",
        "spin"
      ],
      "description": "Optional visual animation preset",
      "default": "none"
    },
    "layerIndex": {
      "type": "number",
      "description": "Exact timeline layer to use. Lower layer numbers render on top. Omit for intent-based placement.",
      "minimum": 0
    },
    "placementIntent": {
      "type": "string",
      "enum": [
        "overlay",
        "background",
        "exact"
      ],
      "description": "Layer intent used when layerIndex is omitted. Use overlay for visible B-roll/logo/sticker over video, background for behind video, exact when layerIndex is supplied.",
      "default": "overlay"
    },
    "allowDuplicate": {
      "type": "boolean",
      "description": "Allow inserting the same asset more than once",
      "default": true
    }
  },
  "required": [
    "projectId",
    "assetId"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "description": "BlitzReels project ID. UUID string.",
      "format": "uuid"
    },
    "assetId": {
      "type": "string",
      "description": "Audio media asset ID. UUID string.",
      "format": "uuid"
    },
    "startSeconds": {
      "type": "number",
      "description": "Timeline start time in seconds",
      "default": 0,
      "minimum": 0
    },
    "durationSeconds": {
      "type": "number",
      "description": "Optional duration. Required if the audio asset duration is not known yet.",
      "minimum": 0
    },
    "volume": {
      "type": "number",
      "description": "Audio volume multiplier, 1 is normal",
      "default": 1
    },
    "fadeInSeconds": {
      "type": "number",
      "description": "Fade-in length in seconds",
      "default": 0,
      "minimum": 0
    },
    "fadeOutSeconds": {
      "type": "number",
      "description": "Fade-out length in seconds",
      "default": 0,
      "minimum": 0
    },
    "loop": {
      "type": "boolean",
      "description": "Loop audio to fill requested duration",
      "default": false
    }
  },
  "required": [
    "projectId",
    "assetId"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "description": "BlitzReels project ID. UUID string.",
      "format": "uuid"
    },
    "resolution": {
      "type": "string",
      "enum": [
        "720p",
        "1080p",
        "4k"
      ],
      "description": "Export resolution",
      "default": "1080p"
    },
    "format": {
      "type": "string",
      "enum": [
        "mp4",
        "mov",
        "fcpxml"
      ],
      "description": "Export container format",
      "default": "mp4"
    },
    "coverFrameSeconds": {
      "type": "number",
      "description": "Optional cover thumbnail timestamp",
      "minimum": 0
    },
    "idempotencyKey": {
      "type": "string",
      "description": "Retry key. Reuse only with identical inputs."
    }
  },
  "required": [
    "projectId"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "kind": {
      "type": "string",
      "enum": [
        "image",
        "video",
        "voiceover",
        "music",
        "sound",
        "faceless"
      ],
      "description": "Generation kind to describe."
    }
  },
  "required": [
    "kind"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "prompt": {
      "type": "string",
      "minLength": 8,
      "maxLength": 5000,
      "description": "What the image should show (8-5000 characters)."
    },
    "model": {
      "type": "string",
      "enum": [
        "fal-ai/gpt-image-1",
        "fal-ai/gpt-image-1.5",
        "fal-ai/gpt-image-2",
        "fal-ai/bytedance/seedream/v5/lite/text-to-image",
        "bytedance/seedream/v5/pro/text-to-image",
        "fal-ai/krea-2/turbo",
        "fal-ai/krea/v2/medium/turbo/text-to-image",
        "fal-ai/krea/v2/medium/text-to-image",
        "fal-ai/nano-banana-2",
        "google/nano-banana-2-lite",
        "fal-ai/nano-banana-pro"
      ],
      "description": "Image model. Call generation_options_list for costs.",
      "default": "fal-ai/nano-banana-2"
    },
    "aspectRatio": {
      "type": "string",
      "enum": [
        "1:1",
        "16:9",
        "9:16",
        "4:3",
        "3:4",
        "3:2",
        "2:3",
        "5:4",
        "4:5",
        "21:9"
      ],
      "description": "Output aspect ratio.",
      "default": "1:1"
    },
    "referenceAssetIds": {
      "type": "array",
      "items": {
        "type": "string",
        "format": "uuid"
      },
      "maxItems": 4,
      "description": "Up to 4 existing image asset IDs to use as style or subject references.",
      "default": []
    },
    "folderId": {
      "type": "string",
      "format": "uuid",
      "description": "Optional media library folder ID."
    },
    "workspaceId": {
      "type": "string",
      "format": "uuid",
      "description": "Optional workspace ID. Defaults to the user's default workspace. UUID string."
    },
    "idempotencyKey": {
      "type": "string",
      "minLength": 8,
      "maxLength": 200,
      "pattern": "^[A-Za-z0-9._:-]+$",
      "description": "Retry key. Reuse only with identical inputs."
    }
  },
  "required": [
    "prompt"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "prompt": {
      "type": "string",
      "minLength": 3,
      "maxLength": 5000,
      "description": "What should happen in the shot (3-5000 characters)."
    },
    "model": {
      "type": "string",
      "enum": [
        "kling-2.1",
        "kling-2.6-pro",
        "kling-o1",
        "kling-3.0",
        "kling-o3-standard",
        "kling-o3-pro",
        "kling-o3-4k",
        "kling-v3-pro",
        "minimax-01",
        "minimax-hailuo-02",
        "minimax-hailuo-2.3-pro",
        "luma-ray-2",
        "luma-ray-3.2",
        "minimax-hailuo-2.3-pro-t2v",
        "luma-ray-3.2-t2v",
        "sora-2",
        "sora-2-pro",
        "veo3",
        "veo3.1",
        "veo3.1-fast",
        "gemini-omni-flash",
        "veo3-fast",
        "gemini-omni-flash-t2v",
        "wan-2.1",
        "wan-2.7",
        "wan-2.7-ref2v",
        "wan-2.7-t2v",
        "happy-horse",
        "happy-horse-ref2v",
        "happy-horse-t2v",
        "pixverse-v6",
        "pixverse-v6-t2v",
        "krea-wan-14b-t2v",
        "grok-imagine",
        "grok-imagine-t2v",
        "sora-2-t2v",
        "sora-2-pro-t2v",
        "seedance-2.0-pro",
        "seedance-2.0-pro-fast",
        "seedance-2.0-ref2v",
        "seedance-2.0-ref2v-fast",
        "seedance-2.0-pro-t2v",
        "seedance-2.0-pro-fast-t2v",
        "seedance-1.5-pro",
        "seedance-1.5-pro-t2v",
        "seedance-1.0-pro",
        "seedance-1.0-pro-t2v",
        "seedance-1.0-pro-fast",
        "seedance-1.0-pro-fast-t2v",
        "seedance-1.0-lite",
        "seedance-1.0-lite-t2v",
        "seedance-1.0-lite-ref2v",
        "kling-o3-standard-t2v",
        "kling-o3-pro-t2v",
        "kling-v3-standard-t2v",
        "kling-v3-pro-t2v",
        "ltx-2-19b",
        "ltx-2-19b-distilled",
        "ltx-2-19b-t2v",
        "ltx-2-19b-distilled-t2v"
      ],
      "description": "Video model. Supported durations and text-to-video vs image-to-video differ per model; call generation_options_list first.",
      "default": "wan-2.1"
    },
    "durationSeconds": {
      "type": "integer",
      "minimum": 2,
      "maximum": 30,
      "description": "Clip length in seconds (2-30). Must be supported by the chosen model.",
      "default": 5
    },
    "aspectRatio": {
      "type": "string",
      "enum": [
        "9:16",
        "16:9",
        "1:1"
      ],
      "description": "Output aspect ratio.",
      "default": "9:16"
    },
    "sourceAssetId": {
      "type": "string",
      "format": "uuid",
      "description": "Source image asset ID. Required by image-to-video models."
    },
    "referenceAssetIds": {
      "type": "array",
      "items": {
        "type": "string",
        "format": "uuid"
      },
      "maxItems": 29,
      "description": "Reference image asset IDs. Seedance 2.5 accepts 29 plus sourceAssetId, for 30 images total; other models accept up to 4.",
      "default": []
    },
    "referenceVideoAssetIds": {
      "type": "array",
      "items": {
        "type": "string",
        "format": "uuid"
      },
      "maxItems": 10,
      "description": "Seedance 2.5 reference video asset IDs. Unsupported by other models.",
      "default": []
    },
    "referenceAudioAssetIds": {
      "type": "array",
      "items": {
        "type": "string",
        "format": "uuid"
      },
      "maxItems": 10,
      "description": "Seedance 2.5 reference audio asset IDs. Unsupported by other models.",
      "default": []
    },
    "resolution": {
      "type": "string",
      "enum": [
        "480p",
        "720p"
      ],
      "description": "Seedance 2.5 output resolution."
    },
    "generateAudio": {
      "type": "boolean",
      "description": "Generate audio alongside the video when supported.",
      "default": true
    },
    "negativePrompt": {
      "type": "string",
      "maxLength": 2500,
      "description": "What to avoid in the shot."
    },
    "seed": {
      "type": "integer",
      "description": "Optional seed for reproducible output."
    },
    "folderId": {
      "type": "string",
      "format": "uuid",
      "description": "Optional media library folder ID."
    },
    "workspaceId": {
      "type": "string",
      "format": "uuid",
      "description": "Optional workspace ID. Defaults to the user's default workspace. UUID string."
    },
    "idempotencyKey": {
      "type": "string",
      "minLength": 8,
      "maxLength": 200,
      "pattern": "^[A-Za-z0-9._:-]+$",
      "description": "Retry key. Reuse only with identical inputs."
    }
  },
  "required": [
    "prompt"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "text": {
      "type": "string",
      "minLength": 3,
      "maxLength": 8000,
      "description": "Script to read aloud (3-8000 characters)."
    },
    "voiceId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Voice ID. Call generation_options_list with kind voiceover for the catalog.",
      "default": "pNInz6obpgDQGcFmaJgB"
    },
    "voiceStyle": {
      "type": "string",
      "enum": [
        "curiosity",
        "intrigue",
        "urgency",
        "tension",
        "concern",
        "surprise",
        "hope",
        "satisfaction",
        "inspiration",
        "revelation",
        "neutral"
      ],
      "description": "Delivery emotion.",
      "default": "neutral"
    },
    "speed": {
      "type": "number",
      "minimum": 0.5,
      "maximum": 1.6,
      "description": "Speaking rate between 0.5 and 1.6.",
      "default": 1
    },
    "workspaceId": {
      "type": "string",
      "format": "uuid",
      "description": "Optional workspace ID. Defaults to the user's default workspace. UUID string."
    },
    "idempotencyKey": {
      "type": "string",
      "minLength": 8,
      "maxLength": 200,
      "pattern": "^[A-Za-z0-9._:-]+$",
      "description": "Retry key. Reuse only with identical inputs."
    }
  },
  "required": [
    "text"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "prompt": {
      "type": "string",
      "maxLength": 500,
      "description": "Optional description of the track.",
      "default": ""
    },
    "mood": {
      "type": "string",
      "enum": [
        "curiosity",
        "intrigue",
        "urgency",
        "tension",
        "concern",
        "surprise",
        "hope",
        "satisfaction",
        "inspiration",
        "revelation",
        "neutral"
      ],
      "description": "Track mood.",
      "default": "neutral"
    },
    "durationSeconds": {
      "type": "number",
      "minimum": 10,
      "maximum": 120,
      "description": "Track length between 10 and 120 seconds.",
      "default": 30
    },
    "workspaceId": {
      "type": "string",
      "format": "uuid",
      "description": "Optional workspace ID. Defaults to the user's default workspace. UUID string."
    },
    "idempotencyKey": {
      "type": "string",
      "minLength": 8,
      "maxLength": 200,
      "pattern": "^[A-Za-z0-9._:-]+$",
      "description": "Retry key. Reuse only with identical inputs."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "prompt": {
      "type": "string",
      "minLength": 3,
      "maxLength": 500,
      "description": "The sound to create (3-500 characters)."
    },
    "durationSeconds": {
      "type": "number",
      "minimum": 0.5,
      "maximum": 30,
      "description": "Effect length between 0.5 and 30 seconds.",
      "default": 2
    },
    "loop": {
      "type": "boolean",
      "description": "Produce a seamlessly loopable effect.",
      "default": false
    },
    "promptInfluence": {
      "type": "number",
      "minimum": 0,
      "maximum": 1,
      "description": "How literally to follow the prompt, between 0 and 1. Higher is more literal.",
      "default": 0.5
    },
    "workspaceId": {
      "type": "string",
      "format": "uuid",
      "description": "Optional workspace ID. Defaults to the user's default workspace. UUID string."
    },
    "idempotencyKey": {
      "type": "string",
      "minLength": 8,
      "maxLength": 200,
      "pattern": "^[A-Za-z0-9._:-]+$",
      "description": "Retry key. Reuse only with identical inputs."
    }
  },
  "required": [
    "prompt"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "script": {
      "type": "string",
      "minLength": 1,
      "maxLength": 30000,
      "description": "The narration or story to turn into a video."
    },
    "projectName": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Name for the created BlitzReels project.",
      "default": "Faceless Video"
    },
    "targetDurationSeconds": {
      "type": "number",
      "minimum": 10,
      "maximum": 120,
      "description": "Target runtime between 10 and 120 seconds.",
      "default": 45
    },
    "visualStyle": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Art direction for the generated scenes.",
      "default": "cinematic 3D animation"
    },
    "plannerModelId": {
      "type": "string",
      "minLength": 3,
      "maxLength": 200,
      "description": "Model used to plan the video scenes.",
      "default": "anthropic/claude-opus-4-6"
    },
    "imageModelId": {
      "type": "string",
      "minLength": 3,
      "maxLength": 200,
      "description": "Model used to generate scene images.",
      "default": "fal-ai/nano-banana-pro"
    },
    "videoModel": {
      "type": "string",
      "enum": [
        "kling-2.1",
        "kling-2.6-pro",
        "kling-o1",
        "kling-3.0",
        "kling-o3-standard",
        "kling-o3-pro",
        "kling-o3-4k",
        "kling-v3-pro",
        "minimax-01",
        "minimax-hailuo-02",
        "minimax-hailuo-2.3-pro",
        "luma-ray-2",
        "luma-ray-3.2",
        "sora-2",
        "sora-2-pro",
        "veo3",
        "veo3.1",
        "veo3.1-fast",
        "gemini-omni-flash",
        "wan-2.7",
        "wan-2.7-ref2v",
        "happy-horse",
        "happy-horse-ref2v",
        "pixverse-v6",
        "grok-imagine",
        "seedance-2.0-pro",
        "seedance-2.0-pro-fast",
        "seedance-2.0-ref2v",
        "seedance-2.0-ref2v-fast",
        "seedance-1.5-pro",
        "seedance-1.0-pro",
        "seedance-1.0-pro-fast",
        "seedance-1.0-lite",
        "seedance-1.0-lite-ref2v",
        "ltx-2-19b",
        "ltx-2-19b-distilled"
      ],
      "description": "Image-to-video model used to animate scenes.",
      "default": "seedance-2.0-ref2v"
    },
    "generateVoiceover": {
      "type": "boolean",
      "description": "Narrate the script with a generated voice.",
      "default": true
    },
    "voiceId": {
      "type": "string",
      "maxLength": 200,
      "description": "Voice ID used when generateVoiceover is true.",
      "default": "pNInz6obpgDQGcFmaJgB"
    },
    "includeCaptions": {
      "type": "boolean",
      "description": "Burn captions into the timeline.",
      "default": true
    },
    "captionStyleId": {
      "type": "string",
      "maxLength": 200,
      "description": "Optional caption theme ID from captions_themes_list."
    },
    "generateBackgroundMusic": {
      "type": "boolean",
      "description": "Add a generated background track.",
      "default": false
    },
    "generateSoundEffects": {
      "type": "boolean",
      "description": "Add generated sound effects.",
      "default": false
    },
    "workspaceId": {
      "type": "string",
      "format": "uuid",
      "description": "Optional workspace ID. Defaults to the user's default workspace. UUID string."
    },
    "idempotencyKey": {
      "type": "string",
      "minLength": 8,
      "maxLength": 200,
      "pattern": "^[A-Za-z0-9._:-]+$",
      "description": "Retry key. Reuse only with identical inputs."
    }
  },
  "required": [
    "script"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "jobId": {
      "type": "string",
      "format": "uuid",
      "description": "Job ID returned by any generation_*_create tool."
    },
    "workspaceId": {
      "type": "string",
      "format": "uuid",
      "description": "Optional workspace ID. Defaults to the user's default workspace. UUID string."
    }
  },
  "required": [
    "jobId"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "jobId": {
      "type": "string",
      "format": "uuid",
      "description": "Job ID returned by any generation_*_create tool."
    },
    "workspaceId": {
      "type": "string",
      "format": "uuid",
      "description": "Optional workspace ID. Defaults to the user's default workspace. UUID string."
    }
  },
  "required": [
    "jobId"
  ],
  "additionalProperties": false
}