Recraft Crisp Upscale API
POST Base URL:
https://api.hiapi.ai /v1/tasks 图片、视频和音频模型通过统一异步接口 POST /v1/tasks 调用，区别只在 input 字段（见下方 input 参数）。
模型概览
| 模型名称 | recraft/crisp-upscale |
|---|---|
| 类型 | 图像编辑（图片放大） |
| 接口 | POST /v1/tasks |
| 价格 | 见 HiAPI 定价 |
Recraft Crisp Upscale:一张图片 URL 进,宽高各放大 2 倍、细节更清晰的图片出,画面内容不变,适合产品图、带文字的横幅、截图和设计素材。
生产建议
生产环境建议
- 生产环境建议在请求体顶层传 callback.url，让 HiAPI 在任务进入终态时主动通知你的服务，减少无效轮询。
- GET /v1/tasks/:id 更适合本地调试、低频任务，或作为回调失败后的补偿查询。
- 产物 URL 有有效期,拿到结果后请及时转存到自己的存储。
- 提交前先校验输入图的格式和大小(≤10MB),超限任务会直接失败。
适用场景
电商产品图
把低分辨率商品图放大 2 倍，用于详情页和大图展示。
image_url带文字的横幅与截图
字形保持不变、边缘更锐利，不会生成新文字。
image_url素材与纹理
材质、纹理和设计素材放大后细节依然连贯。
image_url请求参数
model string 必填 固定填 recraft/crisp-upscale。
input object 必填 业务参数对象；recraft/crisp-upscale 只有一个输入字段。
image_url string 必填 待放大图片的公网可访问 URL(http/https)。JPEG/PNG/WEBP;单张不超过 10MB。
callback object 可选 可选回调配置；设置后任务进入终态时 HiAPI 会主动通知你的服务，减少轮询。
url string 必填 传入 callback 时必填；接收任务终态通知的 HTTPS 地址。
when enum 可选 回调触发时机；当前建议固定为 final。
用例示例
产品图 2 倍放大
640×640 的陶瓷滴滤杯产品图实测输出 1280×1280，釉面竖纹和布纹更清晰。
请求体
{
"model": "recraft/crisp-upscale",
"input": {
"image_url": "https://dev-static.hiapi.ai/model-onboarding/recraft-crisp-upscale/2026/10/16/1792139966228-25c647f84f4600ac-c1-ceramic-640.jpg"
}
}获取结果
- 提交成功后立即返回 taskId（不等待生成完成）。
- 生产环境优先等待 callback.url 收到终态通知；本地调试时可轮询 GET /v1/tasks/:id。
- status=success 后，从返回的 output[].url 下载放大后的 JPEG 图片。
- 如果 status=fail，按返回的错误信息修正请求，不要盲目重试同一个无效请求。
常见问题
会放大多少倍?
宽和高各放大 2 倍,例如 640×640 输出 1280×1280。
输出是什么格式?
一张 JPEG 图片。
对输入图有什么要求?
JPEG/PNG/WEBP,单张不超过 10MB,需为公网可访问的 http(s) URL。
需要写 prompt 吗?
不需要。该模型只接收一张图片 URL,没有其他参数。