跳到主要内容

让你的 AI Agent 连接 Topaz

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

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

试试这些 Topaz 任务

将提示词复制到已安装 oo Skill 的 Agent,补充页面链接和原始笔记后执行。

oo SkillTopaz

放大图片

提交图片并获取增强结果。

/oo Topaz: 用 Topaz 将[图片 URL]放大到 2048 像素宽,并返回下载链接。

增强视频

处理 S3 中的视频并跟踪进度。

/oo Topaz: 用 Topaz 的[模型]将[S3 视频预签名 URL]增强至[输出分辨率],保留音频。

开始使用 Topaz

  1. 安装 OOMOL

    在 Agent 中配置 oo CLI 和 oo Skill。

    安装 OOMOL →
  2. 连接 Topaz

    连接 Topaz API 密钥。

    连接 Topaz→
  3. 向 Agent 交代任务

    使用 /oo,说明要读取的页面、修改的内容和保存位置。

    连接指南 →
  • 在 https://account.topazlabs.com/manage-api 创建密钥。
  • 处理任务需要 API 积分。
  • 图片支持 URL 或已有 Topaz 源图片 ID,视频 Express 需要外部 S3 存储访问。
  • 视频 Express 默认无音频,保留音频时设置 audioTransfer 和 audioCodec。
  • 图片下载链接一小时后过期,视频下载链接保留原到期时间。
  • Express 是最简单的视频流程。标准请求允许先查看费用再接受;外部上传工具可衔接接受请求和确认上传操作。

Topaz 工具

支持精确和生成式图片增强、锐化、降噪、修复、光照、抠图及透明图片放大。可预估处理成本、管理图片和视频任务、获取下载、查看视频指标及查询 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

常见问题

处理会立即完成吗?

处理是异步的,提交后查询任务状态,再获取已完成的结果。

处理视频前可以先查看费用吗?

可以。create_video_request 返回预估而不开始处理,accept_video_request 接受费用。Express 则会立即开始处理外部来源。