{ "openapi": "3.0.1", "info": { "title": "Video Auto Reframe Crop Keyframes", "description": "Analyze authorized direct video URLs and export normalized speaker-following crop keyframes for vertical podcast editing, without identity recognition or persistent face embeddings.", "version": "0.1", "x-build-id": "gI8SMIQCp406qcgeL" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/automation-lab~video-speaker-crop-keyframes/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-automation-lab-video-speaker-crop-keyframes", "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/automation-lab~video-speaker-crop-keyframes/runs": { "post": { "operationId": "runs-sync-automation-lab-video-speaker-crop-keyframes", "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/automation-lab~video-speaker-crop-keyframes/run-sync": { "post": { "operationId": "run-sync-automation-lab-video-speaker-crop-keyframes", "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", "required": [ "videoUrls", "authorized" ], "properties": { "videoUrls": { "title": "Direct video URLs", "type": "array", "description": "1–5 anonymous HTTP(S) MP4/MOV, WebM/Matroska or AVI downloads on ports 80/443. Each download is capped at 250 MiB and 90 seconds; redirects are checked against private network access. No page URLs, playlists, credentials or login. Exact duplicate URLs are analyzed once. Source query strings are omitted from output.", "items": { "type": "string" } }, "authorized": { "title": "I am authorized to analyze these videos", "type": "boolean", "description": "Required explicit consent: true only when you own the video or have permission to perform automated face-location and motion analysis. Does not authorize identity recognition; no face embeddings are generated.", "default": false }, "maxAnalysisSeconds": { "title": "Maximum seconds analyzed per video", "minimum": 1, "maximum": 600, "type": "integer", "description": "Analyze the beginning of each distinct video, up to this many seconds (1–600, default 120). Longer videos produce an explicit truncation warning. Short videos stop at their actual end. The entire bounded media file must still be downloaded. Zero/unlimited is unsupported.", "default": 120 }, "sampleFps": { "title": "Analysis samples per second", "minimum": 2, "maximum": 8, "type": "integer", "description": "Integer from 2 to 8 sampled frames per second, default 4. One keyframe per sampled frame; timestamps are relative to the original video start. Higher sampling increases compute and temporal detail, not a guarantee of correct speaker detection.", "default": 4 }, "targetAspectRatio": { "title": "Target crop aspect ratio", "enum": [ "9:16", "1:1", "4:5", "16:9" ], "type": "string", "description": "Output rectangle pixel aspect ratio: 9:16 (default), 1:1, 4:5 or 16:9. Crop stays inside the orientation-corrected source; no padding or rendering is performed. A narrow crop may not contain every face.", "default": "9:16" } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }