接口提示
tencent_mps_image_super_resolution 每次处理一张图片, 通过异步任务返回一张超分结果
percent 表示缩放倍率, 2 表示 2 倍, 不是 2%
tencent_mps_image_super_resolution 固定输出 JPEG 图片, 质量为 80
认证
authorization string 必需
所有 API 均使用 Bearer Token 鉴权
获取 API Key：
访问 API Key 管理页面 获取 API Key
用法：
将以下 Header 添加到请求中：
Authorization: Bearer YOUR_API_KEY参数
请求体使用 model 和 input 两个顶层字段, 图片参数放在 input[0].params 中
model string 必需
请求使用的模型 ID
值: tencent_mps_image_super_resolution
input array 必需
输入列表, 仅包含一个对象
params
object必需图片处理参数
input_url
string必需输入图片的 HTTP(S) URL, 服务端需能直接访问, 且链接在处理期间保持有效
示例:
https://example.com/input-image.webppercent
number图片缩放倍率
默认值:
2范围:
1–10
轮询
由于结果生成需要时间，您需要在创建任务后轮询任务状态
初始响应只返回任务 ID 和初始状态等信息，最终生成结果需通过使用该任务 ID 轮询任务状态接口获取
轮询请求与响应示例见右侧
创建接口为 POST /model/v1/generation, 查询接口为 GET /model/v1/generation/task/{task_id}. 将创建响应的 id 填入查询路径
创建响应即使返回 status: "completed", 也仅代表创建请求完成. 图片是否生成成功应以查询响应的 status 和 output 为准
建议每隔 5 秒查询一次. 查询状态为 in_progress 时继续等待, 为 completed 且存在图片结果时读取 output[].content[], 为 failed 时停止查询并检查 error. 处理时长随图片和服务负载变化
响应格式
右侧展示创建、处理中和成功查询示例. 示例任务 ID 与图片 URL 均为占位值, 使用时替换成自己的值
id string
平台任务 ID, 用于查询该任务
created_at integer
任务创建时间, Unix 毫秒时间戳
status string
查询状态: in_progress、completed 或 failed
model string
本次请求使用的模型 ID
output array
成功查询返回的图片结果, 路径为 output[].content[]
content
array图片内容列表
type
string值:
imageurl
string结果图片的下载地址. 地址可能包含签名参数, 请保留完整 URL 并及时下载保存, 不应假定永久有效
size
string实际输出尺寸, 格式为
宽x高示例:
1280x1686
usage object
成功查询返回的用量与计价信息
| 字段 | 类型 | 说明 |
|---|---|---|
output_width | integer | 实际输出宽度, 单位为像素 |
output_height | integer | 实际输出高度, 单位为像素 |
output_image_count | integer | 输出图片数量, 为 1 |
image_count | integer | 图片数量, 为 1 |
quantity | number | 计费数量, 为 1 张 |
unit_price | string | 命中档位的每张单价, 单位为 USD |
cost | string | 本次任务返回的计价金额, 单位为 USD |
user_discount | number | 兼容返回字段, 不用于自行重算最终折扣; 0 不代表免费 |
input_tokens / output_tokens / total_tokens | number 或 null | 本模型按图片计费, 示例中为 null |
extra_info | object 或 null | 附加信息, 示例中为 null |
金额示例来自一次测试, 不代表固定报价. 最终入账以平台账单为准
error object
失败时的错误信息, 优先读取 error.message. 如响应包含 error.code, 可一并用于排查. 不依赖示例错误文本进行程序判断
失败查询结构示例（错误文本仅作示意）：
{
"id": "task_id",
"created_at": 1790664422443,
"status": "failed",
"model": "tencent_mps_image_super_resolution",
"error": {
"message": "Image processing failed"
}
}计费说明
按实际输出图片的短边 s = min(output_width, output_height) 选档, 每次成功输出按 1 张计量
| 档位 | 输出短边 s（像素） |
|---|---|
| 720p | 0 < s ≤ 720 |
| 1080p | 720 < s ≤ 1080 |
| 2K | 1080 < s ≤ 1440 |
| 4K | 1440 < s ≤ 2160 |
| 8K | 2160 < s ≤ 4320 |
例如输出为 1280x1686 时, 短边为 1280, 命中 2K 档, 数量为 1 张. 档位名称用于计价分类, 不代表必须输出某个固定尺寸
具体售价、汇率和账户折扣以平台配置与账单为准. 当前计价覆盖输出短边至 4320 像素; 这不是模型能力上限声明, 更大输出的计费口径需另行确认