{
  "openapi": "3.0.1",
  "info": {
    "title": "Cinematic Shot Breakdown: Cuts, Camera & AI Video Prompts",
    "description": "Cinematic shot breakdown for a clip up to 120 s: every cut, shot timing, estimated camera movement, lighting, palette and rhythm, plus Sora, Veo, Kling and Runway prompts per shot. Optional BYOK vision. $0.01 per 10 seconds of video.",
    "version": "1.0",
    "x-build-id": "abHNFcUGcVRqPtaON"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/ferrolark~cinematic-shot-breakdown/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-ferrolark-cinematic-shot-breakdown",
        "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/ferrolark~cinematic-shot-breakdown/runs": {
      "post": {
        "operationId": "runs-sync-ferrolark-cinematic-shot-breakdown",
        "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/ferrolark~cinematic-shot-breakdown/run-sync": {
      "post": {
        "operationId": "run-sync-ferrolark-cinematic-shot-breakdown",
        "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": {
          "videoUrl": {
            "title": "Video file URL",
            "type": "string",
            "description": "A direct link to a video file you own or may analyse (MP4, MOV, WebM, MKV...), up to 120 s and 250 MB. Links to YouTube, TikTok, Instagram, Vimeo and other platforms that forbid downloads are refused. The prefilled link is the Sintel trailer (Blender Foundation, CC BY 3.0). If empty, its first 10 s are analysed as a free demo."
          },
          "videoBase64": {
            "title": "Video as base64",
            "type": "string",
            "description": "For n8n/Make binaries: the clip as base64 or a data: URL. Keep the whole input under about 9 MB; use a URL for bigger clips."
          },
          "fileName": {
            "title": "File name (for base64 input)",
            "type": "string",
            "description": "Optional, for example spot.mp4."
          },
          "rightsConfirmed": {
            "title": "I own this clip or have the right to analyse it",
            "type": "boolean",
            "description": "Required for your own clips (not needed for the public Sintel sample). The clip is only analysed; nothing from it is published or redistributed.",
            "default": false
          },
          "maxSeconds": {
            "title": "Max seconds to analyse",
            "minimum": 5,
            "maximum": 120,
            "type": "integer",
            "description": "Clips longer than this fail (not charged) unless 'trimToLimit' is on.",
            "default": 120
          },
          "trimToLimit": {
            "title": "Analyse only the first 'max seconds'",
            "type": "boolean",
            "description": "For longer clips: analyse the start and ignore the rest.",
            "default": false
          },
          "cutSensitivity": {
            "title": "Cut sensitivity",
            "type": "string",
            "description": "PySceneDetect adaptive threshold. Lower (2.0) finds more cuts, higher (4.5) fewer. 3.0 suits most edits.",
            "default": "3.0"
          },
          "minShotSeconds": {
            "title": "Shortest shot (seconds)",
            "type": "string",
            "description": "Cuts closer than this are merged (flash frames).",
            "default": "0.4"
          },
          "visionProvider": {
            "title": "Vision model (BYOK)",
            "enum": [
              "none",
              "gemini",
              "openai",
              "openrouter",
              "anthropic"
            ],
            "type": "string",
            "description": "Optional: describe subject, setting, shot size, angle, lens and mood with your own API key. You pay the provider directly (typically well under $0.01 per minute of video). Without a key the run still succeeds with the measured breakdown.",
            "default": "none"
          },
          "visionApiKey": {
            "title": "Your API key",
            "type": "string",
            "description": "Used only for this run's requests to the provider you picked; never logged or stored."
          },
          "visionModel": {
            "title": "Model override",
            "type": "string",
            "description": "Optional, any vision model id of the provider."
          },
          "maxShotsForVision": {
            "title": "Max shots sent to the model",
            "minimum": 1,
            "maximum": 200,
            "type": "integer",
            "description": "Caps your provider cost on very fast edits.",
            "default": 60
          },
          "saveKeyframes": {
            "title": "Save keyframes to the run's private storage",
            "type": "boolean",
            "description": "Keeps the 1-2 analysed frames per shot in this run's key-value store (private to your account, no public links).",
            "default": false
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}