Creative 的请求很短：指定模型和一张图片。接入时更容易弄错的是图片用途和尺寸边界。它会重画细节，适合允许局部变化的素材；输入的尺寸限制也不能当成输出尺寸承诺。
TL;DR
Recraft Creative Upscale 每张 $0.3575；查看价格和预算。使用 HiAPI /v1/tasks 接口：提交任务拿 taskId，再查询结果。无需提示词。
输入准备与字段
先检查图片的文件大小、宽高和总像素，三个条件都要满足。用可公开读取的 HTTP(S) 地址传图，推荐 PNG。下面示例使用 1254 × 1254 的木屋源图；不要把展示用的结果缩图误填成源图。
| 字段 | 填写方式 |
|---|---|
image_url | 必填；公开 HTTP(S) 图片 URL；20 MB 内、单边 256–4096 像素、总像素不超过 16 MP；推荐 PNG |
提交任务：cURL
下面是 Bash/cURL 示例。先在运行环境配置 HIAPI_API_KEY；请求中的图片 URL 可以替换，密钥保留在服务端环境中。
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": "https://static.hiapi.ai/model-covers/2026/10/22/1792647323763-1285c89c961a9550-1792546247120-1285c89c961a9550-input-mountain-cabin-1254.png"
}
}'
成功提交会返回 data.taskId。保存这个值，供后续查询使用。
查询任务与保存结果
把任务编号放入 TASK_ID，再查询：
curl "https://api.hiapi.ai/v1/tasks/$TASK_ID" \
-H "Authorization: Bearer $HIAPI_API_KEY"
当任务 data.status=success 时，从 data.output[0].url 获取图片并保存。面向持续运行的业务，可在提交请求的顶层设置 callback.url 和 callback.when: "final" 接收结束通知，并按 taskId 去重；成功和失败都可能触发通知。查询方式适合调试和补查。
Python 提交示例
环境需要安装 requests。这里的 timeout=60 是客户端网络请求等待上限，不是图片生成耗时。
import os
import requests
payload = {'model': 'recraft/creative-upscale', 'input': {'image_url': 'https://static.hiapi.ai/model-covers/2026/10/22/1792647323763-1285c89c961a9550-1792546247120-1285c89c961a9550-input-mountain-cabin-1254.png'}}
response = requests.post(
"https://api.hiapi.ai/v1/tasks",
headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
json=payload,
timeout=60,
)
response.raise_for_status()
result = response.json()
task_id = result["data"]["taskId"]
print(task_id)
提交前与结果检查
不要增加 prompt、scale 或风格参数。获取结果后先保存完整图片，再检查局部纹理和尺寸。模型页的 1280 展示缩图与完整文件用途不同；木屋完整结果是 4096 × 4096。返回失败时按返回信息调整输入，不要假定所有失败都与文件大小有关。
FAQ
模型名里用斜杠还是连字符？
API 请求使用 recraft/creative-upscale。网页地址使用 recraft-creative-upscale。
能指定 2 倍或 4 倍吗？
不能。当前输入只提供 image_url，没有倍率字段。
输入最大单边 4096，输出也受这个限制吗？
这里的限制描述输入图片。输出尺寸要读取对应任务结果，不能混为一谈。
任务完成后要保存什么？
从 data.output[0].url 下载完整结果并保存到自己的存储，再核对像素尺寸和重画细节。
