跳转到内容

Topaz Image Upscale

集成

模型 id topaz/upscale/image/precision
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/topaz/upscale/image/precision?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "upscale_factor": 2
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

与示例类似的文件: $0.08 80 API 积分 · ≈ ₽8.38 运行前会测量你的文件 在此页面运行

获取 API 密钥
Topaz Labs 超分辨率 #upscale#restoration#faces

Topaz Labs 的图像放大器,支持面部恢复、去噪和锐化,最高 4x。

Topaz Labs · 图像

你的第一个结果将在此显示

在下方构建请求,并使用你的 API 密钥运行。输出会复制到我们的存储中,可永久保存或免费保存 7 天。

构建请求

控件根据模型架构生成。更改控件时,代码和价格会同步更新。

•必填 image_url
拖放文件,或

用于放大的源图像 URL。

图像放大倍数;例如,2.0 会使宽度和高度都翻倍。

高级 model · output_format · subject_detection · face_enhancement_creativity · face_enhancement_strength · sharpen · denoise · fix_compression · strength · crop_to_fill · face_enhancement
model 默认 Standard V2

精确放大模型选择:Faces 使用 Face Recovery 3 进行面部重建,Text Refine 保留清晰文本和形状,CGI 适用于 artwork 和渲染图形。对于照片,Standard V2 适用于大多数场景,High Fidelity V3 和 High Fidelity V2 保留专业拍摄细节,Low Resolution V2 重建压缩源。

output_format 默认 jpeg

放大图像使用的格式。

subject_detection 默认 All

图像增强期间使用的主体检测设置。

默认 0

人脸增强创意控制,仅在人脸增强启用时生效:设为 1.0 可获得最大创意,设为 0.0 则不使用创意增强。

默认 0.8

人脸增强强度控制,仅在人脸增强启用时生效:设为 1.0 可获得最大增强,设为 0.0 则不增强。

锐化强度,范围为 0.0 到 1.0,默认值取决于模型。

降噪强度,范围为 0.0 到 1.0,默认值取决于模型。

压缩伪影去除强度,范围为 0.0 到 1.0;CGI 不可用。

增强强度,范围为 0.01 到 1.0,仅 Text Refine 支持。

POST /run/topaz/upscale/image/precision?wait=20 报价 → $0.08
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/topaz/upscale/image/precision?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "upscale_factor": 2
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

运行此请求

你的密钥会保留在此浏览器中:仅发送到 Doitong API;只有勾选“记住”后才会保存到 localStorage。 获取 API 密钥

关于 Topaz Image Upscale

使用针对不同来源优化的 Topaz 模型,将照片或渲染图放大至四倍:标准照片、 高保真图像、低分辨率来源、CGI、文本和面部。可选面部增强、去噪、锐化和 压缩修复;输出为 JPEG 或 PNG。

参数

发送规范名称或原生名称之一,不要同时发送两者。 规范名称

名称类型 默认值允许值 描述
image_url必填 image
类型url · image
用于放大的源图像 URL。
model可选
类型enum
默认值Standard V2
Standard V2High Fidelity V3High Fidelity V2Low Resolution V2CGIText RefineFaces
精确放大模型选择:Faces 使用 Face Recovery 3 进行面部重建,Text Refine 保留清晰文本和形状,CGI 适用于 artwork 和渲染图形。对于照片,Standard V2 适用于大多数场景,High Fidelity V3 和 High Fidelity V2 保留专业拍摄细节,Low Resolution V2 重建压缩源。
upscale_factor可选
类型number
默认值2
1 – 4
图像放大倍数;例如,2.0 会使宽度和高度都翻倍。
crop_to_fill可选
类型boolean
默认值false
output_format可选
类型enum
默认值jpeg
jpegpng
放大图像使用的格式。
subject_detection可选
类型enum
默认值All
AllForegroundBackground
图像增强期间使用的主体检测设置。
face_enhancement可选
类型boolean
默认值true
图像的人脸增强开关。
face_enhancement_creativity可选
类型number
默认值0
0 – 1
人脸增强创意控制,仅在人脸增强启用时生效:设为 1.0 可获得最大创意,设为 0.0 则不使用创意增强。
face_enhancement_strength可选
类型number
默认值0.8
0 – 1
人脸增强强度控制,仅在人脸增强启用时生效:设为 1.0 可获得最大增强,设为 0.0 则不增强。
sharpen可选
类型number | null
0 – 1
锐化强度,范围为 0.0 到 1.0,默认值取决于模型。
denoise可选
类型number | null
0 – 1
降噪强度,范围为 0.0 到 1.0,默认值取决于模型。
fix_compression可选
类型number | null
0 – 1
压缩伪影去除强度,范围为 0.0 到 1.0;CGI 不可用。
strength可选
类型number | null
0.01 – 1
增强强度,范围为 0.01 到 1.0,仅 Text Refine 支持。
必填 规范名称,也可接受

文件参数接受公开的 https:// URL、最大 10 MB 的 data: URI,或上传文件的 file_url。 文件

输出

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "topaz/upscale/image/precision",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 80,
    "usd": "0.08",
    "charged": 80,
    "refunded": 0
  },
  "input": {
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "upscale_factor": 2
  },
  "output": {
    "image": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200
    }
  },
  "outputs": [
    {
      "type": "image",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "width": 1024,
      "height": 768,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
你的文件,由你选择每个 outputs[].url 都是存储中的副本:可永久保存(按 GB-月付费),也可免费保存 7 天,由账户设置或 ?storage= 决定。
每个模型的结构相同图像、视频和音频均包含 type、url、content_type、width、height 和 duration。output 是模型自身的结果对象。
输出字段
image
object {url, content_type, file_name, file_size}通过放大生成的图像。

更多模型:超分辨率

对于 AI 代理:此页面的 Markdown 版本位于 https://doitong.com/zh/developers/models/topaz/upscale/image/precision.md. 所有模型和指南: https://doitong.com/developers/llms.txt