{ "openapi": "3.0.1", "info": { "title": "Old Photo Restoration: Colorize, Restore Faces & Upscale", "description": "Restore old photos with AI: colorize black-and-white and sepia photos (DDColor), restore blurry faces (GFPGAN v1.4) and upscale small scans 2x or 4x (Real-ESRGAN). Works with photo links, Google Drive, Dropbox and uploads. No API key needed.", "version": "0.1", "x-build-id": "Kf2WMt2yEfGQhJyca" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/jumblemog~old-photo-restoration/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-jumblemog-old-photo-restoration", "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/jumblemog~old-photo-restoration/runs": { "post": { "operationId": "runs-sync-jumblemog-old-photo-restoration", "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/jumblemog~old-photo-restoration/run-sync": { "post": { "operationId": "run-sync-jumblemog-old-photo-restoration", "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": { "imageUrls": { "title": "Photo links", "type": "array", "description": "Direct links to photos (JPEG, PNG, TIFF, WebP, HEIC, BMP, GIF), Google Drive or Dropbox share links, or web pages that declare a main image (for example a museum or archive item page). Instagram, Facebook, X, TikTok and Pinterest links aren't supported because their terms don't allow downloading.", "items": { "type": "string" } }, "files": { "title": "Upload photos", "type": "array", "description": "Upload photos from your computer, or pick files you already stored in an Apify key-value store." }, "colorize": { "title": "Colorize", "enum": [ "auto", "always", "never" ], "type": "string", "description": "auto: colorize black-and-white and sepia photos and leave color photos as they are. always: colorize every photo (useful for faded color photos). never: keep the original colors or tones.", "default": "auto" }, "restoreFaces": { "title": "Restore faces", "type": "boolean", "description": "Find every face and restore it with GFPGAN v1.4: sharper eyes, skin and hair, with scratches and blur on the face removed. Each restored face is billed as a 'face' event.", "default": true }, "faceRestorationStrength": { "title": "Face restoration strength", "minimum": 0.1, "maximum": 1, "type": "number", "description": "1.0 uses the restored face as it is. Lower values blend in the original face, which keeps more of the original look if restored faces look too smooth.", "default": 1 }, "upscale": { "title": "Upscale", "enum": [ "auto", "1x", "2x", "4x" ], "type": "string", "description": "auto: photos up to 600 px are enlarged 4x and photos up to 1200 px 2x, larger ones keep their size. Results are capped at 4096 px on the long side.", "default": "auto" }, "outputFormat": { "title": "Output format", "enum": [ "jpg", "png", "webp" ], "type": "string", "description": "File format of the restored photos.", "default": "jpg" }, "saveComparison": { "title": "Save before/after image", "type": "boolean", "description": "Also save a side-by-side image of the original and the restored photo, handy for sharing.", "default": false }, "maxPhotos": { "title": "Maximum photos", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Stop after this many photos, so the cost of a run stays predictable.", "default": 100 } } }, "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 } } } } } } } } } }