# 将 Topaz 接入 Open Flow

Source: https://openflow.run/zh-cn/integrations/topaz/

[全部集成](https://openflow.run/zh-cn/integrations/)

![](https://static.oomol.com/logo/third-party/topaz.svg)

提交图片 URL 或 S3 视频进行增强，并获取处理结果。

*   [33 个工具](https://openflow.run/zh-cn/integrations/topaz/#integration-actions)
*   API 密钥
*   设计与媒体
*   AI

[连接 Topaz](https://console.openflow.run/connections/topaz)

每月 20,000 次免费应用调用（付费服务另计）

## 可以做什么

支持精确和生成式图片增强、锐化、降噪、修复、光照、抠图及透明图片放大。可预估处理成本、管理图片和视频任务、获取下载、查看视频指标及查询 API 积分用量。

### 图片增强

处理图片、预估成本、查看历史、下载原图和结果，以及取消或删除任务记录。

### 视频增强

创建并处理视频任务，查看模型、预估、指标与历史，管理上传完成、取消请求和删除文件。

### API 积分

查询当前积分余额及历史 API 用量。

## 所有工具

33 个工具

### List Image Jobs

列出图片任务，默认分页；非分页模式返回最近七天的任务。has\_next\_page 为 true 时继续使用 next\_cursor。

`topaz.list_image_jobs`

### Delete Image Job Status

删除一个图片任务状态记录，此操作不同于取消运行中的任务。

`topaz.delete_image_job_status`

### Delete All Image Job Statuses

删除全部图片处理状态记录，清空账户任务历史。

`topaz.delete_all_image_job_statuses`

### Get Image Input Download

获取原始输入图片的临时下载和 HEAD 链接。

`topaz.get_image_input_download`

### Estimate Image

预估标准图片处理积分和耗时，不提交任务。

`topaz.estimate_image`

### Estimate Generative Image

预估生成式图片处理积分和耗时，不提交任务。

`topaz.estimate_generative_image`

### Estimate Images Bulk

一次预估多个图片任务，每个结果可能成功或包含独立错误。

`topaz.estimate_images_bulk`

### Get Video System Status

查询视频服务可用性及当前支持模型代码的权威清单。

`topaz.get_video_system_status`

### Create Video Request

创建标准视频请求并获取费用预估，调用 accept\_video\_request 前不会扣费或开始处理。自动处理外部来源优先使用 submit\_video\_enhancement。

`topaz.create_video_request`

### Accept Video Request

接受视频费用预估并预留积分。外部来源自动开始处理；否则向返回的上传 URL PUT 源文件，再调用 complete\_video\_upload。重复调用返回相同 URL。

`topaz.accept_video_request`

### Complete Video Upload

确认外部工具已完成的视频上传并启动处理。单 URL 上传传入 \[{partNum:1,eTag:unused}\]；分片上传需要传入真实有序分片编号和存储返回的 ETag。

`topaz.complete_video_upload`

### Estimate Video Cancellation

预览现在取消视频请求会扣除及退还的积分，不实际取消。

`topaz.estimate_video_cancellation`

### Delete Video Files

永久删除 Topaz 为该请求存储的源视频及增强结果文件。

`topaz.delete_video_files`

### Get Video Request

查询完整视频请求，包含尚未接受的请求、修正后的来源指标、积分交易和签名下载链接。

`topaz.get_video_request`

### Get Video Metrics

查询视频处理指标；不采用分块处理的请求可能只返回指标不可用的说明。

`topaz.get_video_metrics`

### List Video Requests

按时间倒序列出已接受的视频请求。即使某页不足 50 条，也应继续使用 nextCursor 直到为 null；不包含尚未接受的请求。

`topaz.list_video_requests`

### Get Credit Usage

按时间桶查询历史 API 积分用量，显式日期范围优先于 period。period=1d 覆盖 48 小时；稀疏时间桶不表示请求缺失。

`topaz.get_credit_usage`

### Submit Image Enhancement

提交 Topaz 精确图片放大任务，返回可轮询的任务 ID。

`topaz.submit_image_enhancement`

### Submit Generative Image Enhancement

提交 Topaz 生成式图片增强任务，返回可轮询的任务 ID。

`topaz.submit_generative_image_enhancement`

### Submit Image Sharpening

提交图片锐化任务，恢复清晰度并减少模糊。

`topaz.submit_image_sharpening`

### Submit Generative Image Sharpening

提交生成式图片锐化任务，用于修复严重模糊。

`topaz.submit_generative_image_sharpening`

### Submit Image Denoising

提交图片降噪任务，在保留细节的同时去除噪点。

`topaz.submit_image_denoising`

### Submit Image Restoration

提交生成式照片修复任务，去除灰尘和划痕。

`topaz.submit_image_restoration`

### Submit Image Lighting

提交图片光照、白平衡或上色处理。

`topaz.submit_image_lighting`

### Submit Image Matting

提交图片对象抠图，返回带透明度的 PNG。

`topaz.submit_image_matting`

### Submit Image Tool

使用 Tool API 提交保留透明度的图片放大任务。

`topaz.submit_image_tool`

### Get Image Job

查询图片任务状态和进度，完成后使用 get\_image\_download 获取结果 URL。

`topaz.get_image_job`

### Get Image Download

获取已完成图片的临时下载和 HEAD URL，有效期一小时。

`topaz.get_image_download`

### Cancel Image Job

取消待处理图片任务，已完成或不可取消的任务返回冲突。

`topaz.cancel_image_job`

### Submit Video Enhancement

通过 Express 和 S3 外部存储提交视频增强或补帧，Topaz 读取来源并立即开始处理。保留音频时显式设置 audioTransfer 和 audioCodec。

`topaz.submit_video_enhancement`

### Get Video Job

查询视频处理状态、进度、预估和结果下载链接。重复查询复用原链接，不延长有效期。

`topaz.get_video_job`

### Cancel Video Job

取消视频任务，处理前可能全额退还积分，处理中可能部分退还。

`topaz.cancel_video_job`

### Get Credit Balance

查询可用、预留及总计 Topaz API 积分。

`topaz.get_credit_balance`

没有符合搜索条件的工具。

## 将 Topaz 接入 Open Flow

[连接 Topaz](https://console.openflow.run/connections/topaz)

每月 20,000 次免费应用调用（付费服务另计）
