{"docsConfig":{"theme":"mint","$schema":"https://docs.topyappers.com/docs.json","name":"TopYappers API","colors":{"primary":"#FF6B35","light":"#FF8A65","dark":"#000000"},"logo":{"light":"https://mintcdn.com/topyappers/Uo5q-VNDYe38cQ8d/logo/logo.png?fit=max\u0026auto=format\u0026n=Uo5q-VNDYe38cQ8d\u0026q=85\u0026s=be2b698148c5156a310c666e542d41b1","dark":"https://mintcdn.com/topyappers/Uo5q-VNDYe38cQ8d/logo/logo.png?fit=max\u0026auto=format\u0026n=Uo5q-VNDYe38cQ8d\u0026q=85\u0026s=be2b698148c5156a310c666e542d41b1"},"favicon":"https://mintcdn.com/topyappers/Uo5q-VNDYe38cQ8d/favicon.ico?fit=max\u0026auto=format\u0026n=Uo5q-VNDYe38cQ8d\u0026q=85\u0026s=f255c817d8ad747ca9fa56fc3ce32426","navbar":{"links":[],"primary":{"type":"button","label":"Dashboard","href":"https://www.topyappers.com/profile"}},"footer":{"socials":{"x":"https://x.com/tadasgedgaudas","linkedin":"https://linkedin.com/company/topyappers"}},"styling":{"eyebrows":"breadcrumbs","latex":false},"navigation":{"global":{"anchors":[{"anchor":"Get API key","icon":"key","href":"https://www.topyappers.com/profile"}]},"directory":"card","pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"topyappers","hasAudioNarration":false,"actualSubdomain":"topyappers","customDomains":["docs.topyappers.com"],"gitSource":{"type":"github","owner":"tadasgedgaudas","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a719ae156d559957d3a4ac0","collectionId":"3870619d-c1d4-4bd1-8af7-ab2152300a4d","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6a719ae156d559957d3a4ac0"},"entitlements":{},"buildId":"6a719ae156d559957d3a4ac0:success","clientVersion":"0.0.3965","searchFilterCounts":[{"language":"default","tag":"CRM","count":10},{"language":"default","tag":"CRM API","count":10},{"language":"default","tag":"Reference","count":6},{"language":"default","tag":"Creators API","count":5},{"language":"default","tag":"Creators","count":5},{"language":"default","tag":"Lists","count":5},{"language":"default","tag":"Remix API","count":4},{"language":"default","tag":"Agent Outreach","count":3},{"language":"default","tag":"Agent API","count":3},{"language":"default","tag":"Creator Endpoints","count":3}]},"assistantConfig":{},"hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"isAtlas":false,"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"remix-api/endpoint/image-rewrite","slug":"/remix-api/endpoint/image-rewrite","pageMetadata":{"title":"Upload Images for Remix","openapi":"POST /api/v1/image-rewrite","description":"Process one or more images from provided URLs. The API will download the images, apply transformations, and remove invisible watermarks.","href":"/remix-api/endpoint/image-rewrite"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Process one or more images from provided URLs. The API will download the images, apply transformations, and remove invisible watermarks.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Upload Images for Remix","openapi":"POST /api/v1/image-rewrite","description":"Process one or more images from provided URLs. The API will download the images, apply transformations, and remove invisible watermarks.","href":"/remix-api/endpoint/image-rewrite"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Process Images","description":"Process one or more images from provided URLs. The API will download the images, apply transformations, and remove invisible watermarks.","operationId":"processImages","x-codeSamples":[{"lang":"typescript","label":"TypeScript","source":"async function processImages(\n imageUrls: string[],\n parameters: object,\n apiKey: string\n): Promise\u003cany> {\n const baseUrl = 'https://www.topyappers.com';\n\n const response = await fetch(`${baseUrl}/api/v1/image-rewrite`, {\n method: 'POST',\n headers: {\n 'x-ty-api-key': apiKey,\n 'Content-Type': 'application/json',\n },\n body: JSON.stringify({\n images: imageUrls.map((imageUrl) => ({ image_url: imageUrl })),\n parameters,\n }),\n });\n\n if (!response.ok) {\n throw new Error(`API error: ${response.status}`);\n }\n\n return await response.json();\n}\n\n// Usage\nconst result = await processImages(\n ['https://example.com/image-1.jpg', 'https://example.com/image-2.jpg'],\n { brightness: 0.02, contrast: 1.05, quality: 94 },\n 'YOUR_API_KEY'\n);"},{"lang":"python","label":"Python","source":"import requests\n\nAPI_KEY = \"your-api-key-here\"\nBASE_URL = \"https://www.topyappers.com\"\nIMAGE_URLS = [\n \"https://example.com/image-1.jpg\",\n \"https://example.com/image-2.jpg\"\n]\n\nparameters = {\n \"brightness\": 0.02,\n \"contrast\": 1.05,\n \"quality\": 94\n}\n\nresponse = requests.post(\n f\"{BASE_URL}/api/v1/image-rewrite\",\n headers={\n \"x-ty-api-key\": API_KEY,\n \"Content-Type\": \"application/json\"\n },\n json={\n \"images\": [{\"image_url\": url} for url in IMAGE_URLS],\n \"parameters\": parameters\n }\n)\n\nif response.status_code == 200:\n result = response.json()\n print(f\"Success: {result}\")\nelse:\n print(f\"Error: {response.text}\")"},{"lang":"shell","label":"cURL","source":"curl -X POST https://www.topyappers.com/api/v1/image-rewrite \\\n -H \"x-ty-api-key: YOUR_API_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"images\": [\n { \"image_url\": \"https://example.com/image-1.jpg\" },\n { \"image_url\": \"https://example.com/image-2.jpg\" }\n ],\n \"parameters\": {\n \"brightness\": 0.02,\n \"contrast\": 1.05,\n \"quality\": 94\n }\n }'"}],"requestBody":"bc2d0094-f4f1-4d04-a396-316fccaffc60","responses":{"200":"e6c93b74-75e5-4857-8b96-3b2f05d936b4","400":"8698a4ff-beeb-4eba-9d69-b113880ee7c8","401":"21b15e21-d704-4721-bda1-d72d1e4e2e31","429":"47c928ca-405d-46a7-be58-320db203b433"},"method":"post","type":"path","servers":["c0046a69-aa4f-4320-b397-6d48b92c5b2e"],"security":["7291f92f-beb7-403a-8e02-59122633c3ef"],"path":"/api/v1/image-rewrite","baseUrlOptions":["https://www.topyappers.com"],"title":"Process Images","codeSamples":[{"label":"TypeScript","lang":"typescript","source":"async function processImages(\n imageUrls: string[],\n parameters: object,\n apiKey: string\n): Promise\u003cany> {\n const baseUrl = 'https://www.topyappers.com';\n\n const response = await fetch(`${baseUrl}/api/v1/image-rewrite`, {\n method: 'POST',\n headers: {\n 'x-ty-api-key': apiKey,\n 'Content-Type': 'application/json',\n },\n body: JSON.stringify({\n images: imageUrls.map((imageUrl) => ({ image_url: imageUrl })),\n parameters,\n }),\n });\n\n if (!response.ok) {\n throw new Error(`API error: ${response.status}`);\n }\n\n return await response.json();\n}\n\n// Usage\nconst result = await processImages(\n ['https://example.com/image-1.jpg', 'https://example.com/image-2.jpg'],\n { brightness: 0.02, contrast: 1.05, quality: 94 },\n 'YOUR_API_KEY'\n);"},{"label":"Python","lang":"python","source":"import requests\n\nAPI_KEY = \"your-api-key-here\"\nBASE_URL = \"https://www.topyappers.com\"\nIMAGE_URLS = [\n \"https://example.com/image-1.jpg\",\n \"https://example.com/image-2.jpg\"\n]\n\nparameters = {\n \"brightness\": 0.02,\n \"contrast\": 1.05,\n \"quality\": 94\n}\n\nresponse = requests.post(\n f\"{BASE_URL}/api/v1/image-rewrite\",\n headers={\n \"x-ty-api-key\": API_KEY,\n \"Content-Type\": \"application/json\"\n },\n json={\n \"images\": [{\"image_url\": url} for url in IMAGE_URLS],\n \"parameters\": parameters\n }\n)\n\nif response.status_code == 200:\n result = response.json()\n print(f\"Success: {result}\")\nelse:\n print(f\"Error: {response.text}\")"},{"label":"cURL","lang":"shell","source":"curl -X POST https://www.topyappers.com/api/v1/image-rewrite \\\n -H \"x-ty-api-key: YOUR_API_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"images\": [\n { \"image_url\": \"https://example.com/image-1.jpg\" },\n { \"image_url\": \"https://example.com/image-2.jpg\" }\n ],\n \"parameters\": {\n \"brightness\": 0.02,\n \"contrast\": 1.05,\n \"quality\": 94\n }\n }'"}],"requiredOnlyExamples":false,"requestExampleType":"codeSamples","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","description":"Image processing request. Send either image_url for a single image or images for a batch of up to 20 images.","required":["image_url"],"example":{"images":[{"image_url":"https://example.com/image-1.jpg"},{"image_url":"https://example.com/image-2.jpg"}],"parameters":{"brightness":0.02,"contrast":1.05,"quality":94}},"properties":{"image_url":{"type":"string","format":"uri","description":"Publicly accessible URL to a single image file","example":"https://example.com/image.jpg","isRequired":true,"uniqueKey":"oneOf.0.image_url","typeLabel":"string\u003curi>"},"images":{"type":"array","minItems":1,"maxItems":20,"description":"Batch of image URLs and optional image-specific parameters","items":{"type":"object","description":"Optional image processing parameters. Global parameters apply to every image unless an image includes its own value.","required":["image_url"],"example":{"brightness":0.02,"contrast":1.05,"saturation":1.03,"hue":2,"quality":94,"zoomFactor":1.02,"deviceModel":"iPhone 16 Pro"},"properties":{"image_url":{"type":"string","format":"uri","description":"Publicly accessible URL to the image file","example":"https://example.com/image.jpg","isRequired":true,"uniqueKey":"oneOf.0.images.items.[INDEX].image_url","typeLabel":"string\u003curi>"},"zoomFactor":{"type":"number","minimum":0.5,"maximum":2,"default":1,"description":"Zoom level for the image","uniqueKey":"oneOf.0.images.items.[INDEX].zoomFactor","typeLabel":"number"},"saturation":{"type":"number","minimum":0,"maximum":2,"default":1,"description":"Color saturation multiplier","uniqueKey":"oneOf.0.images.items.[INDEX].saturation","typeLabel":"number"},"brightness":{"type":"number","minimum":-1,"maximum":1,"default":0,"description":"Brightness adjustment","uniqueKey":"oneOf.0.images.items.[INDEX].brightness","typeLabel":"number"},"contrast":{"type":"number","minimum":0,"maximum":2,"default":1,"description":"Contrast multiplier","uniqueKey":"oneOf.0.images.items.[INDEX].contrast","typeLabel":"number"},"hue":{"type":"number","minimum":-180,"maximum":180,"default":0,"description":"Hue adjustment in degrees","uniqueKey":"oneOf.0.images.items.[INDEX].hue","typeLabel":"number"},"hueShift":{"type":"number","minimum":-180,"maximum":180,"default":0,"description":"Alias for hue adjustment in degrees","uniqueKey":"oneOf.0.images.items.[INDEX].hueShift","typeLabel":"number"},"gamma":{"type":"number","minimum":0.1,"maximum":3,"default":1,"description":"Gamma correction value","uniqueKey":"oneOf.0.images.items.[INDEX].gamma","typeLabel":"number"},"temperature":{"type":"number","minimum":0.1,"maximum":2,"default":1,"description":"Color temperature adjustment","uniqueKey":"oneOf.0.images.items.[INDEX].temperature","typeLabel":"number"},"noise":{"type":"number","minimum":0,"maximum":0.5,"default":0,"description":"Amount of noise to add","uniqueKey":"oneOf.0.images.items.[INDEX].noise","typeLabel":"number"},"sharpness":{"type":"number","minimum":0,"maximum":2,"default":1,"description":"Sharpness multiplier","uniqueKey":"oneOf.0.images.items.[INDEX].sharpness","typeLabel":"number"},"quality":{"type":"integer","minimum":60,"maximum":100,"default":94,"description":"Output image quality","uniqueKey":"oneOf.0.images.items.[INDEX].quality","typeLabel":"integer"},"flipHorizontal":{"type":"boolean","default":false,"description":"Whether to flip the image horizontally","uniqueKey":"oneOf.0.images.items.[INDEX].flipHorizontal","typeLabel":"boolean"},"flipVertical":{"type":"boolean","default":false,"description":"Whether to flip the image vertically","uniqueKey":"oneOf.0.images.items.[INDEX].flipVertical","typeLabel":"boolean"},"deviceModel":{"type":"string","description":"Target device profile for media metadata","enum":["iPhone 17 Pro Max","iPhone 17 Pro","iPhone 17","iPhone 16 Pro Max","iPhone 16 Pro","iPhone 16","iPhone 15 Pro Max","iPhone 15 Pro","iPhone 15","iPhone 14 Pro Max","iPhone 14 Pro","iPhone 14","iPhone 13 Pro Max","iPhone 13 Pro","iPhone 13","Ray-Ban Meta Smart Glasses"],"uniqueKey":"oneOf.0.images.items.[INDEX].deviceModel","typeLabel":"enum\u003cstring>"}},"uniqueKey":"oneOf.0.images.items.[INDEX]","typeLabel":"object"},"uniqueKey":"oneOf.0.images","typeLabel":"object[]"},"parameters":{"type":"object","description":"Optional image processing parameters. Global parameters apply to every image unless an image includes its own value.","properties":{"zoomFactor":{"type":"number","minimum":0.5,"maximum":2,"default":1,"description":"Zoom level for the image","uniqueKey":"oneOf.0.parameters.zoomFactor","typeLabel":"number"},"saturation":{"type":"number","minimum":0,"maximum":2,"default":1,"description":"Color saturation multiplier","uniqueKey":"oneOf.0.parameters.saturation","typeLabel":"number"},"brightness":{"type":"number","minimum":-1,"maximum":1,"default":0,"description":"Brightness adjustment","uniqueKey":"oneOf.0.parameters.brightness","typeLabel":"number"},"contrast":{"type":"number","minimum":0,"maximum":2,"default":1,"description":"Contrast multiplier","uniqueKey":"oneOf.0.parameters.contrast","typeLabel":"number"},"hue":{"type":"number","minimum":-180,"maximum":180,"default":0,"description":"Hue adjustment in degrees","uniqueKey":"oneOf.0.parameters.hue","typeLabel":"number"},"hueShift":{"type":"number","minimum":-180,"maximum":180,"default":0,"description":"Alias for hue adjustment in degrees","uniqueKey":"oneOf.0.parameters.hueShift","typeLabel":"number"},"gamma":{"type":"number","minimum":0.1,"maximum":3,"default":1,"description":"Gamma correction value","uniqueKey":"oneOf.0.parameters.gamma","typeLabel":"number"},"temperature":{"type":"number","minimum":0.1,"maximum":2,"default":1,"description":"Color temperature adjustment","uniqueKey":"oneOf.0.parameters.temperature","typeLabel":"number"},"noise":{"type":"number","minimum":0,"maximum":0.5,"default":0,"description":"Amount of noise to add","uniqueKey":"oneOf.0.parameters.noise","typeLabel":"number"},"sharpness":{"type":"number","minimum":0,"maximum":2,"default":1,"description":"Sharpness multiplier","uniqueKey":"oneOf.0.parameters.sharpness","typeLabel":"number"},"quality":{"type":"integer","minimum":60,"maximum":100,"default":94,"description":"Output image quality","uniqueKey":"oneOf.0.parameters.quality","typeLabel":"integer"},"flipHorizontal":{"type":"boolean","default":false,"description":"Whether to flip the image horizontally","uniqueKey":"oneOf.0.parameters.flipHorizontal","typeLabel":"boolean"},"flipVertical":{"type":"boolean","default":false,"description":"Whether to flip the image vertically","uniqueKey":"oneOf.0.parameters.flipVertical","typeLabel":"boolean"},"deviceModel":{"type":"string","description":"Target device profile for media metadata","enum":["iPhone 17 Pro Max","iPhone 17 Pro","iPhone 17","iPhone 16 Pro Max","iPhone 16 Pro","iPhone 16","iPhone 15 Pro Max","iPhone 15 Pro","iPhone 15","iPhone 14 Pro Max","iPhone 14 Pro","iPhone 14","iPhone 13 Pro Max","iPhone 13 Pro","iPhone 13","Ray-Ban Meta Smart Glasses"],"uniqueKey":"oneOf.0.parameters.deviceModel","typeLabel":"enum\u003cstring>"}},"example":{"brightness":0.02,"contrast":1.05,"saturation":1.03,"hue":2,"quality":94,"zoomFactor":1.02,"deviceModel":"iPhone 16 Pro"},"uniqueKey":"oneOf.0.parameters","typeLabel":"object"}},"uniqueKey":"oneOf.0","typeLabel":"object"},{"type":"object","description":"Image processing request. Send either image_url for a single image or images for a batch of up to 20 images.","required":["images"],"example":{"images":[{"image_url":"https://example.com/image-1.jpg"},{"image_url":"https://example.com/image-2.jpg"}],"parameters":{"brightness":0.02,"contrast":1.05,"quality":94}},"properties":{"images":{"type":"array","minItems":1,"maxItems":20,"description":"Batch of image URLs and optional image-specific parameters","items":{"type":"object","description":"Optional image processing parameters. Global parameters apply to every image unless an image includes its own value.","required":["image_url"],"example":{"brightness":0.02,"contrast":1.05,"saturation":1.03,"hue":2,"quality":94,"zoomFactor":1.02,"deviceModel":"iPhone 16 Pro"},"properties":{"image_url":{"type":"string","format":"uri","description":"Publicly accessible URL to the image file","example":"https://example.com/image.jpg","isRequired":true,"uniqueKey":"oneOf.1.images.items.[INDEX].image_url","typeLabel":"string\u003curi>"},"zoomFactor":{"type":"number","minimum":0.5,"maximum":2,"default":1,"description":"Zoom level for the image","uniqueKey":"oneOf.1.images.items.[INDEX].zoomFactor","typeLabel":"number"},"saturation":{"type":"number","minimum":0,"maximum":2,"default":1,"description":"Color saturation multiplier","uniqueKey":"oneOf.1.images.items.[INDEX].saturation","typeLabel":"number"},"brightness":{"type":"number","minimum":-1,"maximum":1,"default":0,"description":"Brightness adjustment","uniqueKey":"oneOf.1.images.items.[INDEX].brightness","typeLabel":"number"},"contrast":{"type":"number","minimum":0,"maximum":2,"default":1,"description":"Contrast multiplier","uniqueKey":"oneOf.1.images.items.[INDEX].contrast","typeLabel":"number"},"hue":{"type":"number","minimum":-180,"maximum":180,"default":0,"description":"Hue adjustment in degrees","uniqueKey":"oneOf.1.images.items.[INDEX].hue","typeLabel":"number"},"hueShift":{"type":"number","minimum":-180,"maximum":180,"default":0,"description":"Alias for hue adjustment in degrees","uniqueKey":"oneOf.1.images.items.[INDEX].hueShift","typeLabel":"number"},"gamma":{"type":"number","minimum":0.1,"maximum":3,"default":1,"description":"Gamma correction value","uniqueKey":"oneOf.1.images.items.[INDEX].gamma","typeLabel":"number"},"temperature":{"type":"number","minimum":0.1,"maximum":2,"default":1,"description":"Color temperature adjustment","uniqueKey":"oneOf.1.images.items.[INDEX].temperature","typeLabel":"number"},"noise":{"type":"number","minimum":0,"maximum":0.5,"default":0,"description":"Amount of noise to add","uniqueKey":"oneOf.1.images.items.[INDEX].noise","typeLabel":"number"},"sharpness":{"type":"number","minimum":0,"maximum":2,"default":1,"description":"Sharpness multiplier","uniqueKey":"oneOf.1.images.items.[INDEX].sharpness","typeLabel":"number"},"quality":{"type":"integer","minimum":60,"maximum":100,"default":94,"description":"Output image quality","uniqueKey":"oneOf.1.images.items.[INDEX].quality","typeLabel":"integer"},"flipHorizontal":{"type":"boolean","default":false,"description":"Whether to flip the image horizontally","uniqueKey":"oneOf.1.images.items.[INDEX].flipHorizontal","typeLabel":"boolean"},"flipVertical":{"type":"boolean","default":false,"description":"Whether to flip the image vertically","uniqueKey":"oneOf.1.images.items.[INDEX].flipVertical","typeLabel":"boolean"},"deviceModel":{"type":"string","description":"Target device profile for media metadata","enum":["iPhone 17 Pro Max","iPhone 17 Pro","iPhone 17","iPhone 16 Pro Max","iPhone 16 Pro","iPhone 16","iPhone 15 Pro Max","iPhone 15 Pro","iPhone 15","iPhone 14 Pro Max","iPhone 14 Pro","iPhone 14","iPhone 13 Pro Max","iPhone 13 Pro","iPhone 13","Ray-Ban Meta Smart Glasses"],"uniqueKey":"oneOf.1.images.items.[INDEX].deviceModel","typeLabel":"enum\u003cstring>"}},"uniqueKey":"oneOf.1.images.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"oneOf.1.images","typeLabel":"object[]"},"image_url":{"type":"string","format":"uri","description":"Publicly accessible URL to a single image file","example":"https://example.com/image.jpg","uniqueKey":"oneOf.1.image_url","typeLabel":"string\u003curi>"},"parameters":{"type":"object","description":"Optional image processing parameters. Global parameters apply to every image unless an image includes its own value.","properties":{"zoomFactor":{"type":"number","minimum":0.5,"maximum":2,"default":1,"description":"Zoom level for the image","uniqueKey":"oneOf.1.parameters.zoomFactor","typeLabel":"number"},"saturation":{"type":"number","minimum":0,"maximum":2,"default":1,"description":"Color saturation multiplier","uniqueKey":"oneOf.1.parameters.saturation","typeLabel":"number"},"brightness":{"type":"number","minimum":-1,"maximum":1,"default":0,"description":"Brightness adjustment","uniqueKey":"oneOf.1.parameters.brightness","typeLabel":"number"},"contrast":{"type":"number","minimum":0,"maximum":2,"default":1,"description":"Contrast multiplier","uniqueKey":"oneOf.1.parameters.contrast","typeLabel":"number"},"hue":{"type":"number","minimum":-180,"maximum":180,"default":0,"description":"Hue adjustment in degrees","uniqueKey":"oneOf.1.parameters.hue","typeLabel":"number"},"hueShift":{"type":"number","minimum":-180,"maximum":180,"default":0,"description":"Alias for hue adjustment in degrees","uniqueKey":"oneOf.1.parameters.hueShift","typeLabel":"number"},"gamma":{"type":"number","minimum":0.1,"maximum":3,"default":1,"description":"Gamma correction value","uniqueKey":"oneOf.1.parameters.gamma","typeLabel":"number"},"temperature":{"type":"number","minimum":0.1,"maximum":2,"default":1,"description":"Color temperature adjustment","uniqueKey":"oneOf.1.parameters.temperature","typeLabel":"number"},"noise":{"type":"number","minimum":0,"maximum":0.5,"default":0,"description":"Amount of noise to add","uniqueKey":"oneOf.1.parameters.noise","typeLabel":"number"},"sharpness":{"type":"number","minimum":0,"maximum":2,"default":1,"description":"Sharpness multiplier","uniqueKey":"oneOf.1.parameters.sharpness","typeLabel":"number"},"quality":{"type":"integer","minimum":60,"maximum":100,"default":94,"description":"Output image quality","uniqueKey":"oneOf.1.parameters.quality","typeLabel":"integer"},"flipHorizontal":{"type":"boolean","default":false,"description":"Whether to flip the image horizontally","uniqueKey":"oneOf.1.parameters.flipHorizontal","typeLabel":"boolean"},"flipVertical":{"type":"boolean","default":false,"description":"Whether to flip the image vertically","uniqueKey":"oneOf.1.parameters.flipVertical","typeLabel":"boolean"},"deviceModel":{"type":"string","description":"Target device profile for media metadata","enum":["iPhone 17 Pro Max","iPhone 17 Pro","iPhone 17","iPhone 16 Pro Max","iPhone 16 Pro","iPhone 16","iPhone 15 Pro Max","iPhone 15 Pro","iPhone 15","iPhone 14 Pro Max","iPhone 14 Pro","iPhone 14","iPhone 13 Pro Max","iPhone 13 Pro","iPhone 13","Ray-Ban Meta Smart Glasses"],"uniqueKey":"oneOf.1.parameters.deviceModel","typeLabel":"enum\u003cstring>"}},"example":{"brightness":0.02,"contrast":1.05,"saturation":1.03,"hue":2,"quality":94,"zoomFactor":1.02,"deviceModel":"iPhone 16 Pro"},"uniqueKey":"oneOf.1.parameters","typeLabel":"object"}},"uniqueKey":"oneOf.1","typeLabel":"object"}],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"images":[{"image_url":"https://example.com/image-1.jpg"},{"image_url":"https://example.com/image-2.jpg"}],"parameters":{"brightness":0.02,"contrast":1.05,"quality":94}}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"e6c93b74-75e5-4857-8b96-3b2f05d936b4":{"description":"Images processed successfully","content":{"application/json":{"schema":{"type":"object","required":["success","message","data"],"properties":{"success":{"type":"boolean","example":true,"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"message":{"type":"string","example":"Images processed successfully","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"data":{"type":"object","required":["imageCount","result","processedImages"],"properties":{"imageCount":{"type":"integer","description":"Number of images submitted for processing","example":2,"isRequired":true,"uniqueKey":"data.imageCount","typeLabel":"integer"},"result":{"type":"object","properties":{"metadata":{"type":"object","properties":{"tool_time":{"type":"number","description":"Processing time in seconds","example":8.42,"uniqueKey":"data.result.metadata.tool_time","typeLabel":"number"},"count":{"type":"integer","description":"Number of images processed","example":2,"uniqueKey":"data.result.metadata.count","typeLabel":"integer"}},"uniqueKey":"data.result.metadata","typeLabel":"object"},"data":{"type":"object","properties":{"results":{"type":"array","items":{"type":"object","required":["url","applied_params"],"properties":{"url":{"type":"string","format":"uri","description":"URL of the processed image file","example":"https://imgrework.topyappers.com/processed-image.jpg","isRequired":true,"uniqueKey":"data.result.data.results.items.[INDEX].url","typeLabel":"string\u003curi>"},"applied_params":{"type":"object","description":"The actual parameters that were applied to the image","properties":{"brightness":{"type":"number","uniqueKey":"data.result.data.results.items.[INDEX].applied_params.brightness","typeLabel":"number"},"contrast":{"type":"number","uniqueKey":"data.result.data.results.items.[INDEX].applied_params.contrast","typeLabel":"number"},"saturation":{"type":"number","uniqueKey":"data.result.data.results.items.[INDEX].applied_params.saturation","typeLabel":"number"},"hue":{"type":"number","uniqueKey":"data.result.data.results.items.[INDEX].applied_params.hue","typeLabel":"number"},"gamma":{"type":"number","uniqueKey":"data.result.data.results.items.[INDEX].applied_params.gamma","typeLabel":"number"},"temperature":{"type":"number","uniqueKey":"data.result.data.results.items.[INDEX].applied_params.temperature","typeLabel":"number"},"noise":{"type":"number","uniqueKey":"data.result.data.results.items.[INDEX].applied_params.noise","typeLabel":"number"},"sharpness":{"type":"number","uniqueKey":"data.result.data.results.items.[INDEX].applied_params.sharpness","typeLabel":"number"},"quality":{"type":"integer","uniqueKey":"data.result.data.results.items.[INDEX].applied_params.quality","typeLabel":"integer"},"zoom_factor":{"type":"number","uniqueKey":"data.result.data.results.items.[INDEX].applied_params.zoom_factor","typeLabel":"number"},"device_model":{"oneOf":[{"type":"string","uniqueKey":"data.result.data.results.items.[INDEX].applied_params.device_model.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.result.data.results.items.[INDEX].applied_params.device_model.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.result.data.results.items.[INDEX].applied_params.device_model","typeLabel":"string | null"},"flip_horizontal":{"type":"boolean","uniqueKey":"data.result.data.results.items.[INDEX].applied_params.flip_horizontal","typeLabel":"boolean"},"flip_vertical":{"type":"boolean","uniqueKey":"data.result.data.results.items.[INDEX].applied_params.flip_vertical","typeLabel":"boolean"}},"isRequired":true,"uniqueKey":"data.result.data.results.items.[INDEX].applied_params","typeLabel":"object"}},"uniqueKey":"data.result.data.results.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.result.data.results","typeLabel":"object[]"}},"uniqueKey":"data.result.data","typeLabel":"object"}},"isRequired":true,"uniqueKey":"data.result","typeLabel":"object"},"processedImages":{"type":"array","items":{"type":"object","required":["url","applied_params"],"properties":{"url":{"type":"string","format":"uri","description":"URL of the processed image file","example":"https://imgrework.topyappers.com/processed-image.jpg","isRequired":true,"uniqueKey":"data.processedImages.items.[INDEX].url","typeLabel":"string\u003curi>"},"applied_params":{"type":"object","description":"The actual parameters that were applied to the image","properties":{"brightness":{"type":"number","uniqueKey":"data.processedImages.items.[INDEX].applied_params.brightness","typeLabel":"number"},"contrast":{"type":"number","uniqueKey":"data.processedImages.items.[INDEX].applied_params.contrast","typeLabel":"number"},"saturation":{"type":"number","uniqueKey":"data.processedImages.items.[INDEX].applied_params.saturation","typeLabel":"number"},"hue":{"type":"number","uniqueKey":"data.processedImages.items.[INDEX].applied_params.hue","typeLabel":"number"},"gamma":{"type":"number","uniqueKey":"data.processedImages.items.[INDEX].applied_params.gamma","typeLabel":"number"},"temperature":{"type":"number","uniqueKey":"data.processedImages.items.[INDEX].applied_params.temperature","typeLabel":"number"},"noise":{"type":"number","uniqueKey":"data.processedImages.items.[INDEX].applied_params.noise","typeLabel":"number"},"sharpness":{"type":"number","uniqueKey":"data.processedImages.items.[INDEX].applied_params.sharpness","typeLabel":"number"},"quality":{"type":"integer","uniqueKey":"data.processedImages.items.[INDEX].applied_params.quality","typeLabel":"integer"},"zoom_factor":{"type":"number","uniqueKey":"data.processedImages.items.[INDEX].applied_params.zoom_factor","typeLabel":"number"},"device_model":{"oneOf":[{"type":"string","uniqueKey":"data.processedImages.items.[INDEX].applied_params.device_model.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.processedImages.items.[INDEX].applied_params.device_model.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.processedImages.items.[INDEX].applied_params.device_model","typeLabel":"string | null"},"flip_horizontal":{"type":"boolean","uniqueKey":"data.processedImages.items.[INDEX].applied_params.flip_horizontal","typeLabel":"boolean"},"flip_vertical":{"type":"boolean","uniqueKey":"data.processedImages.items.[INDEX].applied_params.flip_vertical","typeLabel":"boolean"}},"isRequired":true,"uniqueKey":"data.processedImages.items.[INDEX].applied_params","typeLabel":"object"}},"uniqueKey":"data.processedImages.items.[INDEX]","typeLabel":"object"},"description":"Processed image URLs normalized for clients","isRequired":true,"uniqueKey":"data.processedImages","typeLabel":"object[]"},"inputImageUrls":{"type":"array","items":{"type":"string","format":"uri","uniqueKey":"data.inputImageUrls.items.[INDEX]","typeLabel":"string\u003curi>"},"description":"Input image URLs that were submitted","uniqueKey":"data.inputImageUrls","typeLabel":"string\u003curi>[]"},"parameters":{"type":"object","description":"Optional image processing parameters. Global parameters apply to every image unless an image includes its own value.","properties":{"zoomFactor":{"type":"number","minimum":0.5,"maximum":2,"default":1,"description":"Zoom level for the image","uniqueKey":"data.parameters.zoomFactor","typeLabel":"number"},"saturation":{"type":"number","minimum":0,"maximum":2,"default":1,"description":"Color saturation multiplier","uniqueKey":"data.parameters.saturation","typeLabel":"number"},"brightness":{"type":"number","minimum":-1,"maximum":1,"default":0,"description":"Brightness adjustment","uniqueKey":"data.parameters.brightness","typeLabel":"number"},"contrast":{"type":"number","minimum":0,"maximum":2,"default":1,"description":"Contrast multiplier","uniqueKey":"data.parameters.contrast","typeLabel":"number"},"hue":{"type":"number","minimum":-180,"maximum":180,"default":0,"description":"Hue adjustment in degrees","uniqueKey":"data.parameters.hue","typeLabel":"number"},"hueShift":{"type":"number","minimum":-180,"maximum":180,"default":0,"description":"Alias for hue adjustment in degrees","uniqueKey":"data.parameters.hueShift","typeLabel":"number"},"gamma":{"type":"number","minimum":0.1,"maximum":3,"default":1,"description":"Gamma correction value","uniqueKey":"data.parameters.gamma","typeLabel":"number"},"temperature":{"type":"number","minimum":0.1,"maximum":2,"default":1,"description":"Color temperature adjustment","uniqueKey":"data.parameters.temperature","typeLabel":"number"},"noise":{"type":"number","minimum":0,"maximum":0.5,"default":0,"description":"Amount of noise to add","uniqueKey":"data.parameters.noise","typeLabel":"number"},"sharpness":{"type":"number","minimum":0,"maximum":2,"default":1,"description":"Sharpness multiplier","uniqueKey":"data.parameters.sharpness","typeLabel":"number"},"quality":{"type":"integer","minimum":60,"maximum":100,"default":94,"description":"Output image quality","uniqueKey":"data.parameters.quality","typeLabel":"integer"},"flipHorizontal":{"type":"boolean","default":false,"description":"Whether to flip the image horizontally","uniqueKey":"data.parameters.flipHorizontal","typeLabel":"boolean"},"flipVertical":{"type":"boolean","default":false,"description":"Whether to flip the image vertically","uniqueKey":"data.parameters.flipVertical","typeLabel":"boolean"},"deviceModel":{"type":"string","description":"Target device profile for media metadata","enum":["iPhone 17 Pro Max","iPhone 17 Pro","iPhone 17","iPhone 16 Pro Max","iPhone 16 Pro","iPhone 16","iPhone 15 Pro Max","iPhone 15 Pro","iPhone 15","iPhone 14 Pro Max","iPhone 14 Pro","iPhone 14","iPhone 13 Pro Max","iPhone 13 Pro","iPhone 13","Ray-Ban Meta Smart Glasses"],"uniqueKey":"data.parameters.deviceModel","typeLabel":"enum\u003cstring>"}},"example":{"brightness":0.02,"contrast":1.05,"saturation":1.03,"hue":2,"quality":94,"zoomFactor":1.02,"deviceModel":"iPhone 16 Pro"},"uniqueKey":"data.parameters","typeLabel":"object"},"appliedParameters":{"type":"array","items":{"type":"object","description":"The actual parameters that were applied to the image","properties":{"brightness":{"type":"number","uniqueKey":"data.appliedParameters.items.[INDEX].brightness","typeLabel":"number"},"contrast":{"type":"number","uniqueKey":"data.appliedParameters.items.[INDEX].contrast","typeLabel":"number"},"saturation":{"type":"number","uniqueKey":"data.appliedParameters.items.[INDEX].saturation","typeLabel":"number"},"hue":{"type":"number","uniqueKey":"data.appliedParameters.items.[INDEX].hue","typeLabel":"number"},"gamma":{"type":"number","uniqueKey":"data.appliedParameters.items.[INDEX].gamma","typeLabel":"number"},"temperature":{"type":"number","uniqueKey":"data.appliedParameters.items.[INDEX].temperature","typeLabel":"number"},"noise":{"type":"number","uniqueKey":"data.appliedParameters.items.[INDEX].noise","typeLabel":"number"},"sharpness":{"type":"number","uniqueKey":"data.appliedParameters.items.[INDEX].sharpness","typeLabel":"number"},"quality":{"type":"integer","uniqueKey":"data.appliedParameters.items.[INDEX].quality","typeLabel":"integer"},"zoom_factor":{"type":"number","uniqueKey":"data.appliedParameters.items.[INDEX].zoom_factor","typeLabel":"number"},"device_model":{"oneOf":[{"type":"string","uniqueKey":"data.appliedParameters.items.[INDEX].device_model.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.appliedParameters.items.[INDEX].device_model.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.appliedParameters.items.[INDEX].device_model","typeLabel":"string | null"},"flip_horizontal":{"type":"boolean","uniqueKey":"data.appliedParameters.items.[INDEX].flip_horizontal","typeLabel":"boolean"},"flip_vertical":{"type":"boolean","uniqueKey":"data.appliedParameters.items.[INDEX].flip_vertical","typeLabel":"boolean"}},"uniqueKey":"data.appliedParameters.items.[INDEX]","typeLabel":"object"},"description":"Parameters applied to each processed image","uniqueKey":"data.appliedParameters","typeLabel":"object[]"},"processingTime":{"oneOf":[{"type":"number","description":"Processing time in seconds","example":8.42,"uniqueKey":"data.processingTime.oneOf.0","typeLabel":"number"},{"type":"null","description":"Processing time in seconds","example":8.42,"uniqueKey":"data.processingTime.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.processingTime","typeLabel":"number | null"}},"isRequired":true,"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"success":{"title":"success","value":{"success":true,"message":"Images processed successfully","data":{"imageCount":2,"inputImageUrls":["https://example.com/image-1.jpg","https://example.com/image-2.jpg"],"parameters":{"brightness":0.02,"contrast":1.05,"quality":94},"result":{"metadata":{"tool_time":8.42,"count":2},"data":{"results":[{"url":"https://imgrework.topyappers.com/processed-image-1.jpg","applied_params":{"brightness":0.02,"contrast":1.05,"quality":94}},{"url":"https://imgrework.topyappers.com/processed-image-2.jpg","applied_params":{"brightness":0.02,"contrast":1.05,"quality":94}}]}},"processedImages":[{"url":"https://imgrework.topyappers.com/processed-image-1.jpg","applied_params":{"brightness":0.02,"contrast":1.05,"quality":94}},{"url":"https://imgrework.topyappers.com/processed-image-2.jpg","applied_params":{"brightness":0.02,"contrast":1.05,"quality":94}}],"appliedParameters":[{"brightness":0.02,"contrast":1.05,"quality":94},{"brightness":0.02,"contrast":1.05,"quality":94}],"processingTime":8.42}}}},"exampleType":"examples"}},"exampleType":"examples"},"8698a4ff-beeb-4eba-9d69-b113880ee7c8":{"description":"Bad request - invalid image URLs or parameters","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Error message describing what went wrong","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"noImages":{"title":"noImages","value":{"error":"No images provided. Please provide image_url or an array of images."}},"tooManyImages":{"title":"tooManyImages","value":{"error":"Maximum 20 images per batch allowed."}},"invalidUrl":{"title":"invalidUrl","value":{"error":"Image at index 0 must have a valid HTTP/HTTPS image_url"}}},"exampleType":"examples"}},"exampleType":"examples"},"21b15e21-d704-4721-bda1-d72d1e4e2e31":{"description":"Unauthorized - invalid or missing API key","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Error message describing what went wrong","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"missingKey":{"title":"missingKey","value":{"error":"Missing API key. Please provide x-ty-api-key header."}},"invalidKey":{"title":"invalidKey","value":{"error":"Invalid API key"}}},"exampleType":"examples"}},"exampleType":"examples"},"47c928ca-405d-46a7-be58-320db203b433":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","example":"Daily limit exceeded. Upgrade your plan or try in 24 hours.","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"retryAfter":{"type":"integer","description":"Number of seconds to wait before retrying","example":86400,"uniqueKey":"retryAfter","typeLabel":"integer"},"limit":{"type":"integer","description":"Daily rate limit","example":100,"uniqueKey":"limit","typeLabel":"integer"}},"example":{"error":"Daily limit exceeded. Upgrade your plan or try in 24 hours.","retryAfter":86400,"limit":100},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"Daily limit exceeded. Upgrade your plan or try in 24 hours.","retryAfter":86400,"limit":100}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"7291f92f-beb7-403a-8e02-59122633c3ef":{"apiKeyAuth":{"type":"apiKey","in":"header","name":"x-ty-api-key","description":"API key for TopYappers API authentication","scopes":[]}}},"servers":{"c0046a69-aa4f-4320-b397-6d48b92c5b2e":{"url":"https://www.topyappers.com"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"x-ty-api-key","description":"API key for TopYappers API authentication","scopes":[]},"schema":{"title":"x-ty-api-key","type":"string","description":"API key for TopYappers API authentication","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"apiKeyAuth","name":"x-ty-api-key"}],"title":"apiKeyAuth"}]},"originalFileLocation":"remix-api/openapi.json"},"subdomain":"topyappers","siteName":"TopYappers API","title":"Upload Images for Remix - TopYappers API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-06-11T13:48:41.380Z","originalFileLocation":"remix-api/endpoint/image-rewrite.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Process one or more images from provided URLs. The API will download the images, apply transformations, and remove invisible watermarks.\">\u003cmeta data-mint-head name=\"application-name\" content=\"TopYappers API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/topyappers/i5TaxY0J1m67YRY1/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/topyappers/i5TaxY0J1m67YRY1/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/topyappers/i5TaxY0J1m67YRY1/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/topyappers/i5TaxY0J1m67YRY1/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/topyappers/i5TaxY0J1m67YRY1/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/topyappers/i5TaxY0J1m67YRY1/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/topyappers/i5TaxY0J1m67YRY1/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/topyappers/i5TaxY0J1m67YRY1/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/topyappers/i5TaxY0J1m67YRY1/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Upload Images for Remix - TopYappers API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Process one or more images from provided URLs. The API will download the images, apply transformations, and remove invisible watermarks.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"TopYappers API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.topyappers.com/remix-api/endpoint/image-rewrite\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://topyappers.mintlify.app/_mintlify/api/og/v2?division=Remix+API\u0026amp;title=Upload+Images+for+Remix\u0026amp;description=Process+one+or+more+images+from+provided+URLs.+The+API+will+download+the+images%2C+apply+transformations%2C+and+remove+invisible+watermarks.\u0026amp;theme=09aa8f68ece295497d69178d\u0026amp;signature=dd0d1e076b9c460a74bc6fc7dbfb567c87d34f7d5cad1316ba3abf3ac7be25b1\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Upload Images for Remix - TopYappers API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Process one or more images from provided URLs. The API will download the images, apply transformations, and remove invisible watermarks.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://topyappers.mintlify.app/_mintlify/api/og/v2?division=Remix+API\u0026amp;title=Upload+Images+for+Remix\u0026amp;description=Process+one+or+more+images+from+provided+URLs.+The+API+will+download+the+images%2C+apply+transformations%2C+and+remove+invisible+watermarks.\u0026amp;theme=09aa8f68ece295497d69178d\u0026amp;signature=dd0d1e076b9c460a74bc6fc7dbfb567c87d34f7d5cad1316ba3abf3ac7be25b1\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/topyappers/i5TaxY0J1m67YRY1/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"TopYappers API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#FF6B35\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.topyappers.com/remix-api/endpoint/image-rewrite\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/remix-api/endpoint/image-rewrite.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.topyappers.com/#organization\",\"name\":\"TopYappers API\",\"url\":\"https://docs.topyappers.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/topyappers/Uo5q-VNDYe38cQ8d/logo/logo.png?fit=max\u0026auto=format\u0026n=Uo5q-VNDYe38cQ8d\u0026q=85\u0026s=be2b698148c5156a310c666e542d41b1\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.topyappers.com#website\",\"name\":\"TopYappers API\",\"url\":\"https://docs.topyappers.com\",\"publisher\":{\"@id\":\"https://docs.topyappers.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.topyappers.com/remix-api/endpoint/image-rewrite#webpage\",\"url\":\"https://docs.topyappers.com/remix-api/endpoint/image-rewrite\",\"name\":\"Upload Images for Remix\",\"description\":\"Process one or more images from provided URLs. The API will download the images, apply transformations, and remove invisible watermarks.\",\"dateModified\":\"2026-06-11T13:48:41.380Z\",\"isPartOf\":{\"@id\":\"https://docs.topyappers.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.topyappers.com/remix-api/endpoint/image-rewrite#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.topyappers.com/remix-api/endpoint/image-rewrite#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Remix API\",\"item\":\"https://docs.topyappers.com/remix-api/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Upload Images for Remix\",\"item\":\"https://docs.topyappers.com/remix-api/endpoint/image-rewrite\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.topyappers.com/remix-api/endpoint/image-rewrite#apireference\",\"headline\":\"Upload Images for Remix\",\"name\":\"Upload Images for Remix\",\"description\":\"Process one or more images from provided URLs. The API will download the images, apply transformations, and remove invisible watermarks.\",\"url\":\"https://docs.topyappers.com/remix-api/endpoint/image-rewrite\",\"mainEntityOfPage\":{\"@id\":\"https://docs.topyappers.com/remix-api/endpoint/image-rewrite#webpage\"},\"dateModified\":\"2026-06-11T13:48:41.380Z\",\"publisher\":{\"@id\":\"https://docs.topyappers.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.topyappers.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"TopYappers API\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"TopYappers API","nav":{"global":{"anchors":[{"anchor":"Get API key","icon":"key","href":"https://www.topyappers.com/profile"}]},"directory":"card","tabs":[{"tab":"Start here","icon":"rocket","pages":[{"title":"Start here","href":""}]},{"tab":"Creators API","icon":"users","pages":[{"title":"Creators API","href":"/creators-api/v2"}]},{"tab":"Viral Content API","icon":"flame","pages":[{"title":"Viral Content API","href":"/viral-content-api/overview"}]},{"tab":"Remix API","icon":"wand-sparkles","groups":[{"group":"Remix API","icon":"sparkles","root":{"title":"Remix API Overview","href":"/remix-api/overview"},"pages":[{"title":"Upload Video for Remix","openapi":"POST /api/v1/remix","description":"Process a video from a provided URL. The API will download the video, apply transformations, and remove invisible watermarks.","href":"/remix-api/endpoint/get"},{"title":"Upload Images for Remix","openapi":"POST /api/v1/image-rewrite","href":"/remix-api/endpoint/image-rewrite"}]}]},{"tab":"CRM","icon":"database","pages":[{"title":"CRM","href":"/crm-api/overview"}]},{"tab":"Agent Outreach","icon":"send","pages":[{"title":"Agent Outreach","href":"/agent-api/overview"}]},{"tab":"Reference","icon":"book-open","pages":[{"title":"Reference","href":"/reference/enums"}]}]},"title":"Upload Images for Remix - TopYappers API","buildId":"dpl_849ArpqvBiCczQiT1Y1stNGpbqHT","deploymentId":"dpl_849ArpqvBiCczQiT1Y1stNGpbqHT","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-Bbp7I60D.js","utils-C3RIvJha.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DqD-vLt8.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-B31Loprg.js","snippetPresets-DKpk-b8t.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-Cj65AhOR.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BXtn5gcC.js","shallow-RY2b03Cp.js","getApiPlaygroundDisplay-B0jeiPk3.js","CodeSnippet-CYgBjjwn.js","CodeSnippets-DOngDrYB.js","Page-n7I5XbKb.js","getPastedJson-DRQbJx-T.js","icon-CQiQCicY.js","MethodPill-BKTLdNtu.js","DuplicateIcon-B9jpAdat.js","createIcon-DCddRrXv.js","DynamicMarkdown-a8hUKrw6.js","SectionHeading-eECVV2eH.js","axios-vUo_bRtp.js","Markdown--GF7ZIpf.js","clsx-DZLdJUrt.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-2LoAhjKH.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-Zwc0ZncM.js"]}