跳转到内容
HiAPI Docs
HiAPI
在线试用 获取 API Key
中文
English 中文

Recraft Creative Upscale API

POST Base URL: https://api.hiapi.ai /v1/tasks

图片、视频和音频模型通过统一异步接口 POST /v1/tasks 调用，区别只在 input 字段（见下方 input 参数）。

模型概览

模型名称 recraft/creative-upscale
类型 图像放大（生成式，重绘细节）
接口 POST /v1/tasks
价格 见 HiAPI 定价

Recraft Creative Upscale：一张图片 URL 进，分辨率更高、纹理和细节经过重绘的图片出，无需提示词；局部结构可能与原图不同。

生产建议

生产环境建议
  • 生产环境建议在请求体顶层传 callback.url，让 HiAPI 在任务进入终态时主动通知你的服务，减少无效轮询。
  • GET /v1/tasks/:id 更适合本地调试、低频任务，或作为回调失败后的补偿查询。
  • 细节会被重新绘制；含精确文字、logo 或商品细节的图片请改用 recraft/crisp-upscale。
  • 产物 URL 有有效期，拿到结果后请及时转存到自己的存储。

适用场景

旧素材翻新

分辨率不够的插画、壁纸、场景图，放大后重新补出纹理。

image_url
生成图放大展示

把生成好的图片放大到大屏、横幅或印刷需要的尺寸。

image_url
风景与场景图

树叶、岩石、云层这类允许重绘的细节放大后更细腻。

image_url

请求参数

model string 必填

固定填 recraft/creative-upscale。

示例 recraft/creative-upscale
input object 必填

业务参数对象；recraft/creative-upscale 只有一个输入字段。

image_url string 必填

待放大图片的公网 http(s) 地址。建议 PNG；不超过 20 MB，每边 256–4096 像素，总像素不超过 16 MP。

callback object 可选

可选回调配置；设置后任务进入终态时 HiAPI 会主动通知你的服务，减少轮询。

url string 必填

传入 callback 时必填；接收任务终态通知的 HTTPS 地址。

示例 https://your-domain.com/hiapi/callback
when enum 可选

回调触发时机；当前建议固定为 final。

默认 final 可选值: final

用例示例

风景图放大

1254×1254 的黄昏山间木屋 PNG 输出 4096×4096；构图和配色基本保留，原木、石墙等细节经过重绘。

请求体
{
  "model": "recraft/creative-upscale",
  "input": {
    "image_url": "https://dev-static.hiapi.ai/model-onboarding/recraft-creative-upscale/2026/10/21/1792546247120-1285c89c961a9550-input-mountain-cabin-1254.png"
  }
}

获取结果

  1. 提交成功后立即返回 taskId（不等待生成完成）。
  2. 生产环境优先等待 callback.url 收到终态通知；本地调试时可轮询 GET /v1/tasks/:id。
  3. status=success 后，从返回的 output[].url 下载图片。
  4. 如果 status=fail，按返回的错误信息修正请求，不要盲目重试同一个无效请求。

常见问题

会放大多少倍？

没有固定倍数参数。本例 1254×1254 输出 4096×4096，其他输入以实际返回为准。

和 recraft/crisp-upscale 有什么区别？

Crisp Upscale 贴近原图；Creative Upscale 会重绘纹理和细节，局部结构可能与原图不同。

对输入图有什么要求？

公网可访问的 http(s) 图片 URL，不超过 20 MB，每边 256–4096 像素，总像素不超过 16 MP；建议 PNG。

需要写 prompt 吗？

不需要。该模型只接收一张图片 URL，没有其他参数。

输出是什么格式？

从 output[].url 下载图片；本例返回 WebP。

下一步