{ "openapi": "3.0.1", "info": { "title": "Ffmpeg Cloud Mcp", "description": "Cloud-based FFmpeg video/audio processing via MCP. Transcode, trim, extract audio, generate thumbnails, resize, compress, merge videos, create GIFs, and add watermarks. No FFmpeg installation needed. Works with Claude Desktop, Cursor, and any MCP client.", "version": "1.2", "x-build-id": "PqaO9jLGIiKejXsGV" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/whitewalk~ffmpeg-cloud-mcp/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-whitewalk-ffmpeg-cloud-mcp", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/whitewalk~ffmpeg-cloud-mcp/runs": { "post": { "operationId": "runs-sync-whitewalk-ffmpeg-cloud-mcp", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/whitewalk~ffmpeg-cloud-mcp/run-sync": { "post": { "operationId": "run-sync-whitewalk-ffmpeg-cloud-mcp", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "tool": { "title": "Tool", "enum": [ "transcode", "extract_audio", "generate_thumbnail", "get_metadata", "trim", "resize", "compress", "merge", "create_gif", "add_watermark" ], "type": "string", "description": "FFmpeg tool to use (leave empty for MCP server mode)", "default": "get_metadata" }, "inputUrl": { "title": "Input URL", "type": "string", "description": "URL of the input video/audio file", "default": "https://commondatastorage.googleapis.com/gtv-videos-bucket/sample/ForBiggerBlazes.mp4" }, "inputUrls": { "title": "Input URLs (for merge)", "type": "array", "description": "Array of video URLs to merge (minimum 2)", "items": { "type": "string" } }, "outputFormat": { "title": "Output Format", "enum": [ "mp4", "webm", "mov", "avi", "mkv", "mp3", "aac", "wav", "flac", "ogg" ], "type": "string", "description": "Output format for transcode (mp4, webm, mov, avi, mkv) or extract_audio (mp3, aac, wav, flac, ogg)" }, "quality": { "title": "Quality", "enum": [ "low", "medium", "high" ], "type": "string", "description": "Quality preset for transcode/compress", "default": "medium" }, "bitrate": { "title": "Audio Bitrate", "enum": [ "128k", "192k", "256k", "320k" ], "type": "string", "description": "Bitrate for audio extraction", "default": "192k" }, "timestamp": { "title": "Timestamp", "type": "string", "description": "Timestamp in HH:MM:SS format (for thumbnail/GIF start)", "default": "00:00:01" }, "startTime": { "title": "Start Time", "type": "string", "description": "Start time in HH:MM:SS format (for trim)" }, "endTime": { "title": "End Time", "type": "string", "description": "End time in HH:MM:SS format (for trim)" }, "width": { "title": "Width", "minimum": 1, "maximum": 7680, "type": "integer", "description": "Output width in pixels" }, "height": { "title": "Height", "minimum": 1, "maximum": 4320, "type": "integer", "description": "Output height in pixels (optional)" }, "preset": { "title": "Size Preset", "enum": [ "1080p", "720p", "480p", "360p", "instagram", "tiktok", "youtube" ], "type": "string", "description": "Preset dimensions for resize" }, "targetSizeMb": { "title": "Target Size (MB)", "minimum": 1, "type": "number", "description": "Target file size in megabytes for compression" }, "duration": { "title": "Duration (seconds)", "minimum": 1, "maximum": 30, "type": "integer", "description": "Duration in seconds for GIF creation", "default": 5 }, "fps": { "title": "FPS", "minimum": 1, "maximum": 30, "type": "integer", "description": "Frames per second for GIF", "default": 10 }, "watermarkUrl": { "title": "Watermark Image URL", "type": "string", "description": "URL of watermark image (PNG recommended)" }, "text": { "title": "Watermark Text", "type": "string", "description": "Text watermark (used if no image provided)" }, "position": { "title": "Watermark Position", "enum": [ "top-left", "top-right", "bottom-left", "bottom-right", "center" ], "type": "string", "description": "Position of watermark", "default": "bottom-right" }, "opacity": { "title": "Watermark Opacity", "minimum": 0, "maximum": 1, "type": "number", "description": "Opacity of watermark (0-1)", "default": 0.7 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } }