---
title: "图片增强接口"
method: POST
path: "/images/enhance"
tags: ["ImageEnhance"]
---

# 图片增强接口

`POST /images/enhance`

对输入图片进行增强处理，提升图片质量和清晰度

## Request body

- object
  - `model` string, required — 图像增强模型
  - `image` union, required
    - string — 单张图片URL/Base64编码数据
    - string[] — 多张图片URL/Base64编码数组列表
  - `size` string — 图片分辨率，支持 144p/240p/360p/480p/540p/720p/1080p/2k，默认为720p
  - `response_format` 'url' | 'b64_json' — 图片响应格式，支持 url/b64_json 两种格式，默认为url
  - `output_format` 'png' | 'jpg' | 'webp' — 图片输出格式，支持 png/jpg/webp 三种格式，默认为png
  - `extra_body` object — 额外参数配置
    - `enable_hdr` boolean — 是否开启hdr能力，默认false
    - `enable_wb` boolean — 是否开启白平衡能力，默认false
    - `hdr_strength` number — hdr强度，值越高，代表hdr效果越明显，取值范围[0,1]，默认1.0
  - `retries` integer — 自动重试次数，默认0，表示失败不重试

## Response `200`

成功响应

- object
  - `task_id` string, required — 任务ID
  - `task_status` 'pending' | 'running' | 'succeed' | 'failed' — 任务状态
  - `created` integer, required — 创建时间戳
  - `data` object[], required — 生成的图片列表
    - `url` string, uri, required — 图片URL
    - `b64_json` string, base64 — 图片Base64编码数据
    - `revised_prompt` string — 优化后的提示文本

## Other responses

- `400` — 参数验证错误
- `401` — 未授权
- `500` — 标准错误响应

---

[API](https://skmtc.dev/geekai/apis/api.md) · [All operations](https://skmtc.dev/geekai/apis/api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/geekai/api/revisions/2bf0c8f70a39/schema)