Recraft

Recraft Creative Upscale

recraft/creative-upscale

生成式图像放大，在提升分辨率的同时重绘补充纹理、细节与人脸特征，适合把低清素材做成高分辨率成品

recraft/creative-upscale

价格

recraft/creative-upscale 每张

单价	$0.3575

定位简介

recraft/creative-upscale 是 Recraft Creative Upscale 系列的生成式图像放大模型，在提升输入图片分辨率的同时，它会基于生成方式重绘纹理、细小细节与面部特征，而不是仅做插值。它接收公网 PNG 图片 URL，支持单边 256–4096 像素、最高 16 MP 的源图，适合需要把低分辨率素材或旧图提升为高分辨率成品的开发者。

核心亮点

放大同时生成式增强细节——相比纯插值只增加像素，它在放大过程中补充纹理与细小元素，输出可用于高清展示。
针对面部特征做改善与锐化——对 AI 生成图或旧素材中模糊的人脸，放大时会一并处理，减少后期单独修脸的工序。
输入尺寸范围较宽——源图支持单边 256–4096 像素、最高 16 MP，从缩略图到较大素材都可作为输入。

能力说明

生成式图像放大：传入 PNG 图片 URL 即可得到放大并增强后的结果，省去本地部署超分模型的工程成本。

纹理与细节补充：对复杂纹理和细小元素，在放大时重绘补足，输出细节更完整的图像资产。

面部特征增强：针对人像类输入，放大过程会改善并锐化面部特征，适合人像素材的批量提升。

URL 直接输入：仅需公网可访问的图片链接，无需上传文件，便于接入已有图床与自动化管线。

适用场景

设计师提升低分辨率素材——输入低清设计稿或外来图片 URL，得到可用于高清展示或印刷的高分辨率成品图。
AI 生成图与旧素材修复——输入模糊的人像或旧图，输出面部与细节更清晰的版本，用于二次发布或素材复用。
自动化图像处理管线——在服务端以图片 URL 批量调用，把放大增强作为流水线中的一环，产出标准化高清图。

限制与选型建议

生成式重绘可能改变原图内容，不适合要求像素级保真或严格还原原始细节的场景。它面向放大增强而非内容生成，也不适合作为通用图生图编辑工具。源图需为公网可访问的 PNG 链接，且受单边 256–4096 像素与 16 MP 上限约束。若只需提升分辨率而希望保持画面内容不变，应改用非生成式的放大方式。

常见问题

查看全部常见问题 →

Recraft Creative Upscale 是做什么的？

把一张图片放大到更高分辨率，同时重新绘制纹理和细节。它不需要提示词，只传一张图片 URL。
和 Recraft Crisp Upscale 有什么区别？

Crisp Upscale 追求贴近原图，适合文字、商品等不能改动的素材；Creative Upscale 会重绘细节，画面更细腻，但局部结构可能和原图不同。
会改变画面内容吗？

整体构图、主体和配色基本保留，但细节是重新绘制的。本页示例中，木屋的原木、石墙和栏杆被重绘得更清楚，门廊旁的小树没有保留，石块的排布也有变化。对细节有严格要求的素材请先在 Playground 确认。
输入图片有什么要求？

传一张公网可访问的 http(s) 图片 URL，不超过 20 MB，每边 256–4096 像素，总像素不超过 16 MP。本页示例使用 PNG 图片，目前建议使用 PNG。

提交生成任务

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

请求头

Authorizationstring必填

账号 API Key，所有请求必填。示例：Bearer YOUR_HIAPI_API_KEY。获取 API Key

Content-Typestring可选

请求体固定按 JSON 解析；如携带，仅接受 application/json（可带 charset），其他取值返回 415。示例：application/json。

Idempotency-Keystring可选

幂等键，最长 255 字节。同账户同键的重试只创建一次任务，重放返回首次 taskId。

幂等键

网络超时或客户端自动重试时，同键只创建一次任务、不会重复扣费（幂等范围 = API Key 所属账户）。建议用业务侧唯一标识做键（如 "order-42"）；同键重放返回首次 taskId，键在首次提交 24 小时后过期。详细的场景矩阵见统一异步接口介绍页。

请求体

modelstring必填

当前固定值：recraft/creative-upscale

routestring可选

当前固定值：default

inputobject必填

recraft/creative-upscale 和线路 default 的业务参数对象，见下方参数表。

image_urlstring必填minLength 1pattern ^https?://

Public URL of the PNG image to upscale. Up to 20 MB, each side 256–4096 px, at most 16 MP.

callbackobject可选

终态通知配置；为空则不回调，由调用方自行查询。详见下方回调说明。

回调（Webhook）

创建任务时提供 callback.url，任务终态时 HiAPI 主动 POST 通知你的服务，可免去轮询。回调请求体与任务详情数据结构同构；签名校验、投递重试与幂等说明见统一异步接口介绍页的回调说明。

urlstring必填

callback 存在时必填；任务终态后向该 URL 发起 POST，须为合法 http(s) URL。

whenstring可选默认值: "final"

当前仅支持 final，即 success / fail 均回调。

可选项：final

storagestring可选默认值: "temp"

产物存储档位：temp（默认，保留约 7 天）或 persistent（长期保存，按大小计费）。余额不足或超出存储上限会静默降级为 temp；实际生效档位见任务详情响应。

可选项：temppersistent

请求示例

# 提交异步任务，成功立即返回 taskId（不等待生成完成）
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "recraft/creative-upscale",
  "input": {
    "image_url": "…"
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "recraft/creative-upscale",
    input: {
      "image_url": "…"
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "recraft/creative-upscale",
        "input": {
          "image_url": "…"
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

获取任务详情

GET https://api.hiapi.ai/v1/tasks/:id

响应字段

taskIdstring必填

任务 ID，前缀固定 tk-hiapi-。

modelstring必填

解析后的模型全名。用 route 参数提交的任务返回 base@线路（如 gpt-image-2/text-to-image@ext）；否则与创建时传入的模型名一致。

routestring可选

仅当任务用显式 route 参数提交时出现，回显提交时的原值。

statusstring必填

任务状态。

状态枚举

queued 已入队，尚未开始。 handling 处理中。 archiving 处理完成，产物准备中。 success 终态：完成，产物可用（返回 output）。 fail 终态：失败（返回 error）。提交后按 status 判断：success 或 fail 为终态，其余为非终态，建议按 1~3 秒间隔轮询直至终态。成功终态后从 output[].url 下载产物，并在 expireAt 前完成下载或转存；需要长期保留时在创建任务时使用 storage: "persistent"。

creatednumber必填

任务创建时间（Unix 秒）。

completednumber必填

进入终态的 Unix 秒；非终态固定为 0。

outputarray可选

仅 status == success 时出现。产物列表，始终为数组，同一任务可能同时返回多个 type（如 video + first_frame）。

Array [ object ]

数组元素

urlstring必填

资源 URL，可直接下载。

typestring必填

当前可能值：video、image、audio、first_frame、last_frame、thumbnail，后续可能会扩展。

expireAtnumber必填

资源可访问截止时间（Unix 秒）；过期前请完成下载或转存。

errorobject可选

仅 status == fail 时出现。

codestring必填

业务错误码。

messagestring必填

错误描述。

响应示例

成功

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

处理中（非终态）

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

失败

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}