WaveSpeedAI Image Upscaler_内容创作 skill-PHP中文网

WaveSpeedAI Image Upscaler

Polar Sponsor

爱发电赞助

.NET 9.0

立即下载

使用 WaveSpeed AI 图像放大器将图片提升至 2K、4K 或 8K 分辨率。输入图片链接即可生成高清版本，支持 JPEG 等格式。

WaveSpeedAI 图像升级器

功能概述

WaveSpeedAI 图像升级器是一项面向实际任务的技能，主要用于升级器使用 WaveSpeed AI 图像升级器将图像升至 2K, 4K, 或 8K 分辨率. 1. 认证；请在 Wavespeed.ai/ accesskey. % 您也可以通过。

核心要点

它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。
使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。
从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。

使用与执行

实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；

结果检查与注意事项

涉及批量任务时，还应保存进度，避免中断后重复操作。该技能适合用于一次性任务，也可以接入自动化工作流，与其他技能或上层代理配合完成更完整的业务链路；在组合使用时，应明确每一步的输入输出关系，并避免不同步骤之间出现参数冲突。

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

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

参数

参数	类型	是否必需	默认值	说明
`image`	string	是	--	待放大的图像 URL
`target_resolution`	string	否	`4k`	目标分辨率，可选值：`2k`、`4k`、`8k`
`output_format`	string	否	`jpeg`	输出格式，可选值：`jpeg`、`png`、`webp`

示例

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 进行有效性校验。