{ "openapi": "3.0.1", "info": { "title": "Jewelry Hand Model Image Generator", "description": "Transform jewelry product photos into stunning professional hand model photography. Perfect for e-commerce stores, luxury brands, and marketing campaigns. Customize every detail: hand poses, skin tones for diversity, backgrounds (marble, wood, concrete), professional lighting, and photography styles", "version": "1.0", "x-build-id": "OC5ar6oOJUh1yIZXw" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parseforge~jewelry-hand-model-image-generator/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parseforge-jewelry-hand-model-image-generator", "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/parseforge~jewelry-hand-model-image-generator/runs": { "post": { "operationId": "runs-sync-parseforge-jewelry-hand-model-image-generator", "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/parseforge~jewelry-hand-model-image-generator/run-sync": { "post": { "operationId": "run-sync-parseforge-jewelry-hand-model-image-generator", "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": [ "inputImages" ], "properties": { "inputImages": { "title": "Input Jewelry Images (1-3)", "maxItems": 3, "type": "array", "description": "Upload 1-3 jewelry images to transform into professional hand model photography. Works with rings, bracelets, necklaces, and more." }, "jewelryType": { "title": "Jewelry Type", "enum": [ "ring", "bracelet", "watch", "necklace", "earrings", "brooch", "pendant", "bangle", "anklet", "chain", "custom" ], "type": "string", "description": "Type of jewelry to showcase: ring, bracelet, watch, necklace, earrings, or other jewelry pieces." }, "handPose": { "title": "Hand Pose", "enum": [ "none", "open-palm", "relaxed", "fist", "pointing", "peace-sign", "holding", "displaying", "elegant", "artistic", "custom" ], "type": "string", "description": "Hand positioning style: 'relaxed' for natural elegant pose, 'open-palm' for showing full hand, 'displaying' for presenting jewelry, 'elegant' for graceful positioning, 'artistic' for dramatic pose, 'custom' for your own description, or 'none' to let AI decide." }, "customHandPose": { "title": "Custom Hand Pose", "type": "string", "description": "Describe your custom hand pose (only used when Hand Pose is set to 'custom')." }, "skinTone": { "title": "Skin Tone", "enum": [ "none", "fair", "light", "medium", "tan", "brown", "dark", "ebony", "custom" ], "type": "string", "description": "Hand model skin tone: choose from fair, light, medium, tan, brown, dark, ebony, 'custom' for your own description, or 'none' to let AI decide." }, "customSkinTone": { "title": "Custom Skin Tone", "type": "string", "description": "Describe your custom skin tone (only used when Skin Tone is set to 'custom')." }, "background": { "title": "Background Style", "enum": [ "none", "white", "black", "grey", "concrete", "marble", "wood", "fabric", "textured", "custom" ], "type": "string", "description": "Background type: 'white' for clean, 'black' for dramatic, 'concrete' for textured modern, 'marble' for luxury, 'wood' for natural, 'fabric' for soft, 'textured' for artistic, 'custom' for your own description, or 'none' to let AI decide." }, "customBackground": { "title": "Custom Background", "type": "string", "description": "Describe your custom background (only used when Background is set to 'custom')." }, "lighting": { "title": "Lighting Style", "enum": [ "none", "soft-natural", "dramatic", "moody", "bright", "side-light", "backlight", "custom" ], "type": "string", "description": "Lighting setup: 'soft-natural' for gentle lighting, 'dramatic' for high contrast, 'moody' for atmospheric, 'bright' for even illumination, 'side-light' for depth, 'backlight' for rim lighting, 'custom' for your own description, or 'none' to let AI decide." }, "customLighting": { "title": "Custom Lighting", "type": "string", "description": "Describe your custom lighting setup (only used when Lighting is set to 'custom')." }, "cameraAngle": { "title": "Camera Angle", "enum": [ "none", "straight-on", "side", "angled", "overhead", "low-angle", "custom" ], "type": "string", "description": "Camera perspective: 'straight-on' for direct view, 'side' for profile, 'angled' for 45-degree perspective, 'overhead' for top-down, 'low-angle' for upward view, 'custom' for your own description, or 'none' to let AI decide." }, "customCameraAngle": { "title": "Custom Camera Angle", "type": "string", "description": "Describe your custom camera angle (only used when Camera Angle is set to 'custom')." }, "imageStyle": { "title": "Photography Style", "enum": [ "none", "editorial", "luxury", "minimalist", "cinematic", "high-fashion", "product", "custom" ], "type": "string", "description": "Overall photography aesthetic: 'editorial' for magazine style, 'luxury' for high-end campaign, 'minimalist' for clean aesthetic, 'cinematic' for film-inspired, 'high-fashion' for runway aesthetic, 'product' for commercial photography, 'custom' for your own description, or 'none' to let AI decide." }, "customImageStyle": { "title": "Custom Image Style", "type": "string", "description": "Describe your custom image style (only used when Photography Style is set to 'custom')." }, "additionalInstructions": { "title": "Additional Instructions", "type": "string", "description": "Optional: Add any specific instructions or details for your jewelry hand model image (e.g., 'focus on ring details', 'warm color tones', 'show articulation')." }, "temperature": { "title": "Creativity Level", "minimum": 0, "maximum": 1, "type": "number", "description": "Controls AI creativity (0.0-1.0). Lower values = more faithful to input, higher values = more artistic interpretation." } } }, "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 } } } } } } } } } }