WaveSpeedAI 图像超分放大器

使用 WaveSpeed AI 的 Image Upscaler 将图像放大至 2K、4K 或 8K 分辨率。

身份认证

export WAVESPEED_API_KEY="your-api-key"

在 wavespeed.ai/accesskey 获取您的 API 密钥。

快速开始

import wavespeed from 'wavespeed';

// 上传本地图像以获取 URL
const imageUrl = await wavespeed.upload("/path/to/photo.png");

const output_url = (await wavespeed.run(
  "wavespeed-ai/image-upscaler",
  { image: imageUrl }
))["outputs"][0];

您也可以直接传入已有的图像 URL：

const output_url = (await wavespeed.run(
  "wavespeed-ai/image-upscaler",
  { image: "https://example.com/photo.jpg" }
))["outputs"][0];

API 接口地址

模型 ID：wavespeed-ai/image-upscaler

将图像放大至更高分辨率。

参数

示例

import wavespeed from 'wavespeed';

const imageUrl = await wavespeed.upload("/path/to/photo.png");

const output_url = (await wavespeed.run(
  "wavespeed-ai/image-upscaler",
  {
    image: imageUrl,
    target_resolution: "8k",
    output_format: "png"
  }
))["outputs"][0];

高级用法

同步模式（Sync Mode）

使用同步模式发起单次请求，该请求会等待结果返回，无需轮询：

const output_url = (await wavespeed.run(
  "wavespeed-ai/image-upscaler",
  { image: imageUrl },
  { enableSyncMode: true }
))["outputs"][0];

自定义客户端（含重试配置）

import { Client } from 'wavespeed';

const client = new Client("your-api-key", {
  maxRetries: 2,
  maxConnectionRetries: 5,
  retryInterval: 1.0,
});

const output_url = (await client.run(
  "wavespeed-ai/image-upscaler",
  { image: imageUrl, target_resolution: "4k" }
))["outputs"][0];

使用 runNoThrow 进行错误处理

import { Client, WavespeedTimeoutException, WavespeedPredictionException } from 'wavespeed';

const client = new Client();
const result = await client.runNoThrow(
  "wavespeed-ai/image-upscaler",
  { image: imageUrl }
);

if (result.outputs) {
  console.log("超分放大后图像 URL:", result.outputs[0]);
  console.log("任务 ID:", result.detail.taskId);
} else {
  console.log("失败:", result.detail.error.message);
  if (result.detail.error instanceof WavespeedTimeoutException) {
    console.log("请求超时 — 建议增加超时时间");
  } else if (result.detail.error instanceof WavespeedPredictionException) {
    console.log("预测执行失败");
  }
}

定价

每张图像 $0.01（适用于所有分辨率）。

安全限制

• 禁止加载任意 URL：仅使用来自可信源的图像 URL。切勿在未经验证的情况下，从不可信或用户提供的 URL 加载图像。
• API 密钥安全：请妥善保管您的 WAVESPEED_API_KEY。切勿将其硬编码在源文件中，也不要提交至版本控制系统。请使用环境变量或密钥管理服务进行存储。
• 输入验证：仅传递本文档中明确列出的参数。在发送请求前，请对图像 URL 进行有效性校验。