配色
笔触
光影
01
上传风格参考图
在 image_urls 放 1–10 张同一画风的图片，PNG、JPG 或 WEBP，每张小于 20 MB。
Recraft V4 Styles Pro API 用 1–10 张参考图定下画风，生成分辨率更高、细节更足的同风格图片，适合海报、印刷物料和品牌主视觉，可在 HiAPI 在线试用并通过 /v1/tasks 接入。
提供商: Recraft
类型: 图像生成
接口: /v1/tasks
状态: 已开放
消耗: 查看页面实时价格
返回模型列表
Recraft V4 Styles Pro
新品提供商 Recraft图像
Recraft V4 Styles Pro API 用 1–10 张参考图定下画风，生成分辨率更高、细节更足的同风格图片，适合海报、印刷物料和品牌主视觉，可在 HiAPI 在线试用并通过 /v1/tasks 接入。
定价
标准用量
300 积分/ 张
输入
0 / 10000
更多参数
生成设置
预估费用300 积分 / 张每张
请先上传参考图
输出
准备生成
配置参数并点击"运行"查看输出结果。
--
参考图与生成结果
案例展示完整输出与原始提示词；提交的两张风格参考图见下方长文。
相关图像模型
根据任务类型、输出档位和参考图需求选择相邻模型。
关于 Recraft V4 Styles Pro
Recraft V4 Styles Pro API 用 1–10 张参考图定下画风，生成分辨率更高、细节更足的同风格图片，适合海报、印刷物料和品牌主视觉，可在 HiAPI 在线试用并通过 /v1/tasks 接入。
本页 Playground 和 API 使用同一个模型 ID：recraft-v4-styles-pro/text-to-image。image_urls 里的 1–10 张参考图决定画风，prompt 描述要画的内容，每次输出 1 张图片。
- 提供商
- Recraft
- 任务
- 文生图
- 参考图
- 1–10 张风格参考图（必填）
- 价格
- 查看实时价格
模型规格
为 Recraft V4 Styles Pro 选择适合创作目标的输入与输出设置。
- 参考图数量
- 1–10 张风格参考图（必填）
- 图片尺寸
- square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
- 风格贴合度
- flexible（默认）precise
- 配色
- colors / background_color（API）
- 输出
- 1 张图片（square_hd 为 2048×2048）
- 提示词长度
- 1–10000 字符
- 价格
- 查看实时价格
最终费用由输出档位和附加输入共同决定，以页面实时价格与任务记录为准。
如何使用 Recraft V4 Styles Pro
先确定画面用途和画幅，再组织主体、场景、材质、光线与文字。
最多 10 张
主体
场景
尺寸预设
02
写提示词并选尺寸
prompt 写要画的主体和场景；image_size 选 6 种预设之一，需要时设置 style_match。
Playground
POST /v1/tasks
03
验证后接入 API
在 Playground 确认画风，再用同一模型 ID 和参数调用 POST /v1/tasks。
API 快速接入
下面是可直接复制的最小请求；完整参数、回调、查询与错误码请查看 Docs。
- 接口
POST /v1/tasks- 模型 ID
recraft-v4-styles-pro/text-to-image
cURL
curl -X POST "https://api.hiapi.ai/v1/tasks" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "recraft-v4-styles-pro/text-to-image",
"input": {
"prompt": "A lighthouse on a cliff with seagulls and waves, no logos, no brand names",
"image_urls": [
"https://static.hiapi.ai/gallery/2026/10/fa10ab95992be1a3.png",
"https://static.hiapi.ai/gallery/2026/10/e96f0a8de9568541.png"
],
"image_size": "square_hd"
}
}'创建请求会立即返回 taskId；图像生成在后台异步完成。
参考图定风格的高分辨率生图
Recraft V4 Styles Pro：按参考图的画风生成更高分辨率的新图，square_hd 达 2048×2048
Recraft V4 Styles Pro 和 Styles 一样把“画风”和“内容”分开：image_urls 里的参考图定下配色、笔触和光影，prompt 描述这一张要画什么。区别在输出分辨率更高，适合海报、印刷物料和需要放大查看细节的主视觉。
1–10 张风格参考图square_hd 输出 2048×20486 种尺寸预设每次 1 张
了解模型与案例 ↓
参考图定风格的高分辨率生图
Recraft V4 Styles Pro 模型介绍
每次请求输出 1 张图片。尺寸用 6 种预设之一选择，默认 square_hd；style_match 控制贴近参考的程度；colors 和 background_color 可以通过 API 进一步指定配色。
下面的案例是本模型的真实结果：两张地中海风景水彩作参考，提示词写“悬崖上的灯塔，海鸥和浪花”，输出 2048×2048，保留了参考图的水彩质感。
怎么准备风格参考图
参考图决定结果的画风，挑图比写长提示词更重要。
用同一种画风的图
几张参考图的配色、笔触和光影一致时，结果的画风最明确。本页示例的两张参考图都是淡彩、留白较多的风景水彩。
内容交给提示词
示例里参考图画的是海港和庭院，结果画的是提示词里的悬崖灯塔。主体、场景和构图写进 prompt，不必让参考图和目标内容相同。
格式与大小
PNG、JPG 或 WEBP，每张小于 20 MB，合计不超过 64 MB，不支持 SVG；API 请求里传公网可访问的 http(s) 地址，最多 10 张。
参考图怎样变成新画面
左侧两张是提交的风格参考图，右侧是 Recraft V4 Styles Pro 的输出（页面显示缩略图，原图 2048×2048）。
2 张参考图 · square_hd
两张水彩参考图 + 一句提示词：悬崖灯塔
参考图是一张停着小船的海港、一张开着木门的花园庭院，两张都是淡蓝天空、米色石块和大面积留白的水彩风景。
提示词只写了“悬崖上的灯塔，海鸥和浪花”。结果画出了层叠石崖上的白色灯塔、几只海鸥和拍岸的浪花，石块的米色、天空的淡蓝和水彩的晕染与参考图一致，参考图里的小船和木门没有出现。
- 参考图
- 2 张
- 尺寸预设
- square_hd
- 输出
- 2048×2048 WebP
A lighthouse on a cliff with seagulls and waves, no logos, no brand names
怎么选
按是否需要参考图、需要多高的分辨率来选。
| 对比项 | Recraft V4 Styles Pro | Recraft V4 Styles | Recraft V4.1 |
|---|---|---|---|
| 画风来源 | 1–10 张参考图 | 1–10 张参考图 | 只靠提示词 |
| square_hd 输出尺寸 | 2048×2048 | 1024×1024 | 1024×1024 |
| 尺寸预设 | 6 种 | 6 种 | 6 种 |
| 适合 | 海报、印刷等需要高分辨率的用途 | 日常配图、批量出同风格图 | 没有参考图、只用文字描述 |
价格以实时价格为准。
三步用起来
在 Playground 里确认画风，再把同样的参数写进 API 请求。
01
1. 上传风格参考图
在 image_urls 放 1–10 张同一画风的图片。
02
2. 写提示词并选尺寸
prompt 写要画的主体和场景；image_size 选 6 种预设之一，需要时设置 style_match。
03
3. 调用 /v1/tasks
提交后立即返回 taskId，任务成功后从 output[].url 下载图片并转存。
适用场景
海报与印刷物料
需要大尺寸输出的海报、展板和印刷品，用 Pro 拿到更高分辨率的原图。
品牌主视觉
用已有的品牌插画作参考生成新的主视觉；需要固定品牌色时再加 colors。
系列插画定稿
先用同一组参考图试稿，确定方向后用 Pro 出需要放大展示的定稿。
细节要经得起放大
画册、长图或网页大图需要放大查看笔触和纹理时，更高的输出分辨率更合适。
价格怎么算
按输出图片张数计费，每次请求 1 张；参考图张数、尺寸预设和 style_match 不影响单价。
当前单价以页面上方和价格页显示的实时价格为准。
用你的参考图试一张
在上方 Playground 上传参考图、写一句提示词，满意后用同样的参数调用 POST /v1/tasks。
需要比较不同模型和计费档位？查看全部模型实时价格
常见问题
Recraft V4 Styles Pro 是做什么的？
用 1–10 张参考图定下画风，再用一句提示词描述要画的内容，模型按参考图的画风生成一张分辨率更高的新图。参考图决定“怎么画”，提示词决定“画什么”。
输出分辨率有多高？
本页示例用 square_hd，输出为 2048×2048 的 WebP 图片。其他尺寸预设的具体像素以实际返回为准。
必须上传参考图吗？最多几张？
必须。image_urls 是必填字段，至少 1 张、最多 10 张。本页示例用了 2 张同一画风的水彩画。
参考图有什么格式和大小要求？
支持 PNG、JPG、WEBP，需为公网可访问的 http(s) 地址；每张小于 20 MB，所有参考图合计不超过 64 MB，不支持 SVG。在 Playground 里也可以直接上传图片。
参考图里的物体会被画进结果里吗？
本页示例中，参考图里的小船、木门和花丛没有出现在结果里，结果画的是提示词里的悬崖灯塔；从参考图继承的是淡蓝天空、米色石块和留白的水彩笔触。想要的主体请写进提示词。
style_match 怎么选？
precise 让结果更贴近参考图的画风，flexible 允许更多变化；不传时按 flexible 处理。本页示例没有传 style_match。
支持哪些尺寸？
image_size 有 square_hd（默认）、square、portrait_4_3、portrait_16_9、landscape_4_3、landscape_16_9 六种预设。
和 Recraft V4 Styles 有什么区别？
两者参数相同。Pro 的输出分辨率更高：同样用 square_hd，Styles 示例输出 1024×1024，Pro 示例输出 2048×2048。两者价格不同，以实时价格为准。
能指定配色和背景色吗？
可以通过 API 传 colors（RGB 对象数组）和 background_color（单个 RGB 对象），每个通道 0–255。在线 Playground 暂不显示这两个参数。
能保存一个风格反复使用吗？
目前不支持传入已保存的风格。每次请求都要带上参考图；想让一组图保持同一画风，就在每次请求里使用同一组参考图。
怎么计费？
按输出图片张数计费，每次请求 1 张；参考图张数、尺寸预设和 style_match 都不影响单价。当前价格见页面上方和价格页。
结果图片会保存多久？
结果链接有有效期，任务成功后请及时把图片转存到自己的存储。