质量增强器（放大）

质量增强器端点允许您智能地放大并增强图像的分辨率和更精细的细节，最高支持4K分辨率。

模型名称: upscale

生命周期: stable

处理时间: ~8s–20s

输出格式: 自动 (JPEG 或 PNG)

交付方式: URL

积分: 每张图片3到4个 (2k: 3, 4k: 4)

请求

将您的图像和目标分辨率提交到通用 /v1/run 端点：

POSThttps://fititon.app/api/v1/run

请求示例

curl -X POST https://fititon.app/api/v1/run \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -d '{
           "model_name": "upscale",
           "inputs": {
             "imageUrl": "https://example.com/1k-image.jpg",
             "targetQuality": "2k"
           }
         }'

响应

由于放大可能需要长达20秒，/v1/run 端点会立即返回 201 Created 状态以及一个异步作业 id。您必须使用此 id 轮询状态API以检索最终图像。或者，您可以配置 Webhook 以自动接收通知。请注意，我们的 Webhook 调度器强制执行严格的 15秒超时。您的服务器必须在15秒内以 2xx 状态码确认 Webhook，否则我们将认为其失败并稍后重试。

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "starting",
  "created_at": "2024-03-10T12:00:00Z",
  "model_name": "upscale"
}

当作业完成 (status: "success") 时，output 字段将包含结果URL的数组：

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "success",
  "output": [
    "https://cdn.fititon.app/users/123/results/upscale-123.jpg"
  ],
  "error": null,
  "created_at": "2024-03-10T12:00:00Z",
  "updated_at": "2024-03-10T12:00:20Z"
}

请求参数

必填参数

imageUrlRequiredstring

您希望放大的源图像。可以是公开可访问的URL，也可以是Base64编码的图像字符串。

格式和负载要求 提交Base64字符串时，必须包含标准数据URI前缀（例如，data:image/jpeg;base64,...）。此外，我们强烈建议对大于3MB的图像使用标准HTTP URL，以避免达到全局JSON负载大小限制（HTTP 413）。

targetQualityRequired'2k' | '4k'

所需的输出分辨率级别。注意：大于 4.25百万像素 的图像不能使用 targetQuality="2k"，必须指定 4k。

运行时错误

此功能的运行时错误使用错误处理中记录的共享错误集。如果在处理过程中发生错误，status 将更新为 "error"，并且 error 字段将包含具体的失败原因。

积分成本

对于开发者API请求，成本根据 targetQuality 进行调整。

公式： Cost = QualityCredits

参数	每张图片积分
`targetQuality="2k"`	3
`targetQuality="4k"`	4