Ad Creative → Shot Spec
Pricing
from $50.00 / 1,000 shot specs
Turn any video ad into a per-shot reconstruction spec — camera, lighting, grade, composition, on-screen text, and a ready-to-paste prompt for Veo, Kling, Runway & Sora. Reconstruction, not scoring. Bring your own LLM key; runs for pennies.
You can access the Ad Creative → Shot Spec programmatically from your own applications by using the Apify API. You can also choose the language preference from below. To use the Apify API, you’ll need an Apify account and your API token, found in API & Integrations in Apify Console.
{ "openapi": "3.0.1", "info": { "version": "0.1", "x-build-id": "AGnzXO16NZ1BCe4aF" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/akki.1008~ad-creative-shot-spec/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-akki.1008-ad-creative-shot-spec", "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/akki.1008~ad-creative-shot-spec/runs": { "post": { "operationId": "runs-sync-akki.1008-ad-creative-shot-spec", "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/akki.1008~ad-creative-shot-spec/run-sync": { "post": { "operationId": "run-sync-akki.1008-ad-creative-shot-spec", "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": [ "provider", "apiKey" ], "properties": { "videoUrls": { "title": "Video URLs", "type": "array", "description": "Direct MP4 (or mov/webm) URLs to analyze. Leave empty if piping in a dataset from an ad-library scraper instead.", "items": { "type": "string" } }, "datasetId": { "title": "Source dataset ID (optional)", "type": "string", "description": "Apify dataset ID from any ad-library scraper. Each item is scanned for a video URL field (videoUrl, video_url, mediaUrl, url)." }, "datasetVideoField": { "title": "Dataset video field", "type": "string", "description": "Which field in the source dataset holds the direct video URL. Auto-detects common names if left blank." }, "provider": { "title": "LLM provider", "enum": [ "gemini", "openai", "anthropic" ], "type": "string", "description": "Which vision model provider your API key is for.", "default": "gemini" }, "apiKey": { "title": "Your LLM API key", "type": "string", "description": "Your own API key, billed directly to you by the provider — never stored, never seen by us. Google Gemini offers a FREE key at aistudio.google.com with no card required." }, "model": { "title": "Model (optional)", "type": "string", "description": "Override the vision model. Defaults: OpenAI = gpt-4o, Anthropic = claude-3-5-sonnet-latest." }, "targetModel": { "title": "Target video model", "enum": [ "generic", "veo", "kling", "runway", "seedance" ], "type": "string", "description": "The generation engine you'll paste prompts into. Adds an engine-tuned modelPrompt alongside the model-agnostic generationPrompt.", "default": "generic" }, "maxScenes": { "title": "Max scenes per video", "minimum": 1, "maximum": 8, "type": "integer", "description": "Cap on shots analyzed per video (= number of vision calls = your LLM cost). Near-duplicate scenes are collapsed.", "default": 5 }, "maxDuration": { "title": "Max video duration (seconds)", "minimum": 2, "maximum": 180, "type": "integer", "description": "Videos longer than this are skipped with an error row rather than run up your bill.", "default": 60 }, "sceneThreshold": { "title": "Scene-cut sensitivity", "minimum": 0.1, "maximum": 0.6, "type": "number", "description": "ffmpeg scene score threshold (0.2 = many cuts, 0.4 = only hard cuts). 0.3 is a good default for ads.", "default": 0.3 } } }, "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 } } } } } } } } }}OpenAPI is a standard for designing and describing RESTful APIs, allowing developers to define API structure, endpoints, and data formats in a machine-readable way. It simplifies API development, integration, and documentation.
OpenAPI is effective when used with AI agents and GPTs by standardizing how these systems interact with various APIs, for reliable integrations and efficient communication.
By defining machine-readable API specifications, OpenAPI allows AI models like GPTs to understand and use varied data sources, improving accuracy. This accelerates development, reduces errors, and provides context-aware responses, making OpenAPI a core component for AI applications.
You can download the OpenAPI definitions for Ad Creative → Shot Spec from the options below:
If you’d like to learn more about how OpenAPI powers GPTs, read our blog post.
You can also check out our other API clients: