RecoupGet a free auditFree audit

API REFERENCE

Upscale Content

On this page
POST/api/content/upscale

Upscale an image or video to higher resolution. Pass the URL and specify the type. Returns the upscaled URL.

Authentication

x-api-key in header

bearerAuth bearer

Request

cURL
curl --request POST \
  --url 'https://api.recoupable.dev/api/content/upscale' \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "url": "string",
  "type": "image"
}'

Try it

Fill in the fields, send the request from your browser, and read the live response. The curl below updates as you type.

Kept in this browser tab only and cleared when it closes.

cURL for this request
curl --request POST \
  --url 'https://recoup-api.vercel.app/api/content/upscale' \
  --header 'Content-Type: application/json' \
  --data '{
  "url": "string",
  "type": "image"
}'

Request body required

Upscale parameters

application/json

urlstringrequired

URL of the image or video to upscale

format: uri

typestring · enumrequired

Whether the input is an image or video

Values: "image", "video"

upscale_factornumber

Upscale multiplier (1-4x). Defaults to 2x.

Default: 2

minimum: 1 · maximum: 4

target_resolutionstring · enum

Target output resolution. When provided, overrides upscale_factor with a resolution-based upscale.

Values: "720p", "1080p", "1440p", "2160p"

Responses

200Media upscaled successfully

application/json

urlstringrequired

URL of the upscaled image or video

format: uri

400Validation failed — invalid or missing request body fields

application/json

errorstringrequired

Error message describing what went wrong

401Unauthorized — invalid or missing API key

application/json

errorstringrequired

Error message describing what went wrong

500Internal server error

application/json

errorstringrequired

Error message describing what went wrong

Full specification

Download the OpenAPI file for complete schemas, constraints, and examples.

Download content.json
View operation source
json
{
  "description": "Upscale an image or video to higher resolution. Pass the URL and specify the type. Returns the upscaled URL.",
  "security": [
    {
      "apiKeyAuth": []
    },
    {
      "bearerAuth": []
    }
  ],
  "requestBody": {
    "description": "Upscale parameters",
    "required": true,
    "content": {
      "application/json": {
        "schema": {
          "$ref": "#/components/schemas/ContentCreateUpscaleRequest"
        }
      }
    }
  },
  "responses": {
    "200": {
      "description": "Media upscaled successfully",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ContentCreateUpscaleResponse"
          }
        }
      }
    },
    "400": {
      "description": "Validation failed — invalid or missing request body fields",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ContentErrorResponse"
          }
        }
      }
    },
    "401": {
      "description": "Unauthorized — invalid or missing API key",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ContentErrorResponse"
          }
        }
      }
    },
    "500": {
      "description": "Internal server error",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ContentErrorResponse"
          }
        }
      }
    }
  }
}