> ## Documentation Index
> Fetch the complete documentation index at: https://docs.omnimux.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Public hosts only: console https://omnimux.ai/dashboard · API https://api.omnimux.ai · docs https://docs.omnimux.ai.
> Gateway auth is Authorization: Bearer sk-… on https://api.omnimux.ai/v1 (OpenAI-compatible Chat Completions and related paths).
> Discover pages from /llms.txt; full site dump /llms-full.txt; product skill /skill.md; docs search MCP /mcp. Prefer .md page URLs for Markdown.
> Default docs locale is en; zh mirrors the same relative paths. Do not invent model ids not present on live pricing or the complete API pages.

# VolcEngine Image Upscaling

> Upscale one existing image to twice its width and height. No prompt is required.

Upscale one existing image to twice its width and height. No prompt is required. API access only.

## Specifications

| Item | Specification |
| - | - |
| Model ID | `volc-image-upscale` |
| Input Source | Provide one public HTTPS image URL that is accessible without authentication. The OmniMux API request still requires authentication. |
| Supported Formats | Supported image formats: JPG, JPEG, PNG, BMP. |
| File Size | File size must not exceed 5 MB. |
| Input Dimensions | Input width must be 50 to 2128 pixels and height 50 to 4064 pixels, inclusive. |
| Magnification | Only fixed 2x upscaling is supported. Text-to-image generation, masks, multiple images, and custom output sizes are not supported. |
| Result Validity | Upstream result URLs are valid for 24 hours and are not permanent. |

## Billing Details

* Official Baseline: 0.006 CNY / call.
* Billing Mode: Fixed per-call billing (UsePrice).
* Refund Protection: Upstream errors, timeouts, or empty image outputs trigger an immediate 100% refund of the reserved quota.


## OpenAPI

````yaml openapi/ops/image/en/volc-image-upscale.json POST /v1/images/edits
openapi: 3.0.3
info:
  title: VolcEngine · Image Upscaling
  version: 1.0.0
servers:
  - url: https://api.omnimux.ai
security: []
paths:
  /v1/images/edits:
    post:
      summary: VolcEngine Image Upscaling
      description: >-
        Upscale one existing image to twice its width and height. No prompt is
        required.
      operationId: upscaleImageVolcEn
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - model
                - image
              properties:
                model:
                  type: string
                  enum:
                    - volc-image-upscale
                  default: volc-image-upscale
                  description: Model identifier, fixed to volc-image-upscale
                image:
                  type: string
                  description: >-
                    Provide one public HTTPS image URL that is accessible
                    without authentication. The OmniMux API request still
                    requires authentication. Supported image formats: JPG, JPEG,
                    PNG, BMP. File size must not exceed 5 MB. Input width must
                    be 50 to 2128 pixels and height 50 to 4064 pixels,
                    inclusive.
            example:
              model: volc-image-upscale
              image: https://example.com/sample.png
      responses:
        '200':
          description: >-
            Super-resolution succeeded, synchronously returning the 2x upscaled
            temporary image URL (valid for 24 hours).
          content:
            application/json:
              schema:
                type: object
                properties:
                  created:
                    type: integer
                    description: Response timestamp
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        url:
                          type: string
                          description: Upscaled image result URL (valid for 24 hours)
              example:
                created: 1727740800
                data:
                  - url: https://visual.volcengine.com/upscaled_result_2x.png
        '400':
          description: >-
            Invalid parameters, non-HTTPS scheme, dimensions out of bounds, file
            exceeds 5 MB, or unsupported format.
        '403':
          description: Insufficient user quota.
        '502':
          description: Upstream Volcengine service error; quota is fully refunded.
      security:
        - BearerAuth: []
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.