{ "openapi": "3.0.1", "info": { "title": "Porosity Analyzer for Metallography (AM & Coatings)", "description": "Area porosity from polished cross-section micrographs (optical or SEM): porosity % with 95 % confidence interval and relative accuracy, pore sizes, largest pores, round vs lack-of-fusion pores, quality checks and a PDF report.", "version": "1.0", "x-build-id": "GUiPIFRhrmmtCE5lk" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/jovianlabs~porosity-analyzer/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-jovianlabs-porosity-analyzer", "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/jovianlabs~porosity-analyzer/runs": { "post": { "operationId": "runs-sync-jovianlabs-porosity-analyzer", "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/jovianlabs~porosity-analyzer/run-sync": { "post": { "operationId": "run-sync-jovianlabs-porosity-analyzer", "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": "Image URLs", "type": "array", "description": "Direct links to micrographs of ONE sample (TIFF, PNG or JPG), all at the same magnification. Use 5 or more fields spread over the section. Leave empty to try the Actor on built-in synthetic cross-sections with known porosity (free).", "items": { "type": "string" } }, "scaleBarUm": { "title": "Scale bar length (µm)", "type": "string", "description": "Length printed on the scale bar of the image data band, in micrometres (e.g. 100). The bar is detected automatically. Optional for original TIFF files from Zeiss or Thermo Fisher (FEI) SEMs: the pixel size is then read from the file metadata." }, "pixelSizeUm": { "title": "Pixel size (µm/px)", "type": "string", "description": "Use for optical micrographs without a data band, e.g. 0.5 at 200x on many cameras. Overrides everything else." }, "sampleName": { "title": "Sample name", "type": "string", "description": "Shown on the report.", "default": "SAMPLE-01" }, "poresAreBright": { "title": "Pores are brighter than the material", "type": "boolean", "description": "Leave off for the usual case (dark pores on bright polished metal or ceramic).", "default": false }, "excludeOutside": { "title": "Exclude mounting resin and empty space", "type": "boolean", "description": "Large dark regions touching the image border (5 % of the field or more) are treated as outside the material, not as pores.", "default": true }, "roundnessRound": { "title": "Roundness for round pores", "type": "string", "description": "Pores with roundness (4·area / π·max Feret²) at or above this value are typed as round (gas or keyhole).", "default": "0.70" }, "roundnessIrregular": { "title": "Roundness for irregular pores", "type": "string", "description": "Pores below this roundness are typed as irregular (likely lack of fusion). Thresholds depend on the alloy and process.", "default": "0.45" }, "threshold": { "title": "Manual grey-level threshold (expert)", "type": "string", "description": "Optional, between 0 and 1 on the normalised image. Leave empty for the automatic threshold, which also corrects uneven illumination." }, "reportLanguage": { "title": "Report language", "enum": [ "en", "fr" ], "type": "string", "description": "Language of the PDF report and CSV headers.", "default": "en" }, "maxImages": { "title": "Maximum number of images", "minimum": 1, "maximum": 50, "type": "integer", "description": "Each analysed image is billed once.", "default": 20 } } }, "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 } } } } } } } } } }