> ## 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.

# 火山引擎 图片超分

> 将一张已有图片的宽与高各放大至原来的两倍，无需提示词。

将一张已有图片的宽与高各放大至原来的两倍，无需提示词。仅提供 API 接入。

## 规格约束

| 项目 | 规范 |
| - | - |
| 模型标识 | `volc-image-upscale` |
| 输入来源 | 输入为一张免鉴权的公网 HTTPS 图片 URL。OmniMux API 请求仍需鉴权。 |
| 支持格式 | 支持 JPG、JPEG、PNG、BMP 图片。 |
| 文件大小 | 文件大小不超过 5 MB。 |
| 输入尺寸 | 输入图片宽度为 50 至 2128 像素，高度为 50 至 4064 像素，均含边界。 |
| 放大倍率 | 仅支持固定两倍超分，不支持文生图、遮罩、多图或自定义输出尺寸。 |
| 结果有效期 | 上游结果 URL 有效期为 24 小时，不保证永久可访问。 |

## 计费说明

* 官方刊例价格：0.006 元/次。
* 计费模式：固定按次计费（UsePrice）。
* 结算保护：上游服务异常、超时或返回空结果时，预扣额度将 100% 自动退回。


## OpenAPI

````yaml openapi/ops/image/zh/volc-image-upscale.json POST /v1/images/edits
openapi: 3.0.3
info:
  title: 火山引擎 · 图片超分
  version: 1.0.0
servers:
  - url: https://api.omnimux.ai
security: []
paths:
  /v1/images/edits:
    post:
      summary: 火山引擎 图片超分
      description: 将一张已有图片的宽与高各放大至原来的两倍，无需提示词。
      operationId: upscaleImageVolcZh
      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: 模型标识，固定为 volc-image-upscale
                image:
                  type: string
                  description: >-
                    输入为一张免鉴权的公网 HTTPS 图片 URL。OmniMux API 请求仍需鉴权。支持
                    JPG、JPEG、PNG、BMP；文件大小不超过 5 MB；宽度 50 至 2128 像素，高度 50 至 4064
                    像素。
            example:
              model: volc-image-upscale
              image: https://example.com/sample.png
      responses:
        '200':
          description: 超分辨率处理成功，同步返回 2 倍放大图片临时 URL（有效期 24 小时）。
          content:
            application/json:
              schema:
                type: object
                properties:
                  created:
                    type: integer
                    description: 响应时间戳
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        url:
                          type: string
                          description: 超分后图片结果 URL（有效期 24 小时）
              example:
                created: 1727740800
                data:
                  - url: https://visual.volcengine.com/upscaled_result_2x.png
        '400':
          description: 请求参数无效、非公网 HTTPS、尺寸超出范围或格式不受支持。
        '403':
          description: 账户额度不足。
        '502':
          description: 上游火山引擎服务异常，已全额退款。
      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.