配色
笔触
光影
01
上传风格参考图
在 image_urls 放 1–10 张同一画风的图片，PNG、JPG 或 WEBP，每张小于 20 MB。
Recraft V4 Styles API 用 1–10 张参考图定下画风，再按一句描述生成同风格的新图，适合系列插画、品牌视觉延展和社媒配图，可在 HiAPI 在线试用并通过 /v1/tasks 接入。
提供商: Recraft
类型: 图像生成
接口: /v1/tasks
状态: 已开放
消耗: 查看页面实时价格
返回模型列表
Recraft V4 Styles
新品提供商 Recraft图像
Recraft V4 Styles API 用 1–10 张参考图定下画风，再按一句描述生成同风格的新图，适合系列插画、品牌视觉延展和社媒配图，可在 HiAPI 在线试用并通过 /v1/tasks 接入。
定价
标准用量
115 积分/ 张
输入
0 / 10000
更多参数
生成设置
预估费用115 积分 / 张每张
请先上传参考图
输出
准备生成
配置参数并点击"运行"查看输出结果。
--
参考图与生成结果
案例展示完整输出与原始提示词；提交的两张风格参考图见下方长文。
相关图像模型
根据任务类型、输出档位和参考图需求选择相邻模型。
关于 Recraft V4 Styles
Recraft V4 Styles API 用 1–10 张参考图定下画风，再按一句描述生成同风格的新图，适合系列插画、品牌视觉延展和社媒配图，可在 HiAPI 在线试用并通过 /v1/tasks 接入。
本页 Playground 和 API 使用同一个模型 ID：recraft-v4-styles/text-to-image。image_urls 里的 1–10 张参考图决定画风，prompt 描述要画的内容，每次输出 1 张图片。
- 提供商
- Recraft
- 任务
- 文生图
- 参考图
- 1–10 张风格参考图（必填）
- 价格
- 查看实时价格
模型规格
为 Recraft V4 Styles 选择适合创作目标的输入与输出设置。
- 参考图数量
- 1–10 张风格参考图（必填）
- 图片尺寸
- square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
- 风格贴合度
- flexible（默认）precise
- 配色
- colors / background_color（API）
- 输出
- 1 张图片
- 提示词长度
- 1–10000 字符
- 价格
- 查看实时价格
最终费用由输出档位和附加输入共同决定，以页面实时价格与任务记录为准。
如何使用 Recraft V4 Styles
先确定画面用途和画幅，再组织主体、场景、材质、光线与文字。
最多 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/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/text-to-image",
"input": {
"prompt": "A cozy corner café on a rainy street at dusk, a cat sitting in the window, no logos, no brand names",
"image_urls": [
"https://static.hiapi.ai/gallery/2026/10/1d68aea559e20871.png",
"https://static.hiapi.ai/gallery/2026/10/01be0ab874ba475e.png"
],
"image_size": "square_hd"
}
}'创建请求会立即返回 taskId；图像生成在后台异步完成。
参考图定风格的文生图
Recraft V4 Styles：用几张参考图定画风，一句话生成同风格新图
Recraft V4 Styles 把“画风”和“内容”分开：image_urls 里的参考图定下配色、笔触和光影，prompt 描述这一张要画什么。适合需要一整套风格统一的插画、海报和社媒配图。
1–10 张风格参考图6 种尺寸预设style_match 两档每次 1 张
了解模型与案例 ↓
参考图定风格的文生图
Recraft V4 Styles 模型介绍
每次请求输出 1 张图片。尺寸用 6 种预设之一选择，默认 square_hd；style_match 控制贴近参考的程度；colors 和 background_color 可以通过 API 进一步指定配色。
下面的案例是本模型的真实结果：两张暖橙配墨绿的平涂插画作参考，提示词写“雨天街角咖啡馆和窗边的猫”，结果画出了新场景，同时保留了参考图的配色和光影。
怎么准备风格参考图
参考图决定结果的画风，挑图比写长提示词更重要。
用同一种画风的图
几张参考图的配色、笔触和光影一致时，结果的画风最明确。本页示例的两张参考图是同一套暖橙配墨绿的平涂插画。
内容交给提示词
示例里参考图画的是室内和庭院，结果画的是提示词里的街角咖啡馆。主体、场景和构图写进 prompt，不必让参考图和目标内容相同。
格式与大小
PNG、JPG 或 WEBP，每张小于 20 MB，合计不超过 64 MB，不支持 SVG；API 请求里传公网可访问的 http(s) 地址，最多 10 张。
参考图怎样变成新画面
左侧两张是提交的风格参考图，右侧是 Recraft V4 Styles 的完整输出。
2 张参考图 · square_hd
两张参考图 + 一句提示词：雨天街角咖啡馆
参考图是一张摆着茶壶和书的暖色室内、一张从窗口望向庭院和自行车的画面，两张都是暖橙配墨绿、平涂加硬朗投影的插画。
提示词只写了“黄昏雨天街角的小咖啡馆，一只猫坐在窗边”。结果画出了带落地窗的转角咖啡馆、窗台上的猫、吊灯和雨丝，配色和光影与参考图一致，参考图里的茶壶和自行车没有出现。
- 参考图
- 2 张
- 尺寸预设
- square_hd
- 输出
- 1024×1024 WebP
A cozy corner café on a rainy street at dusk, a cat sitting in the window, no logos, no brand names
怎么选
按是否需要参考图、需要多高的分辨率来选。
| 对比项 | Recraft V4 Styles | Recraft V4 Styles Pro | Recraft V4.1 |
|---|---|---|---|
| 画风来源 | 1–10 张参考图 | 1–10 张参考图 | 只靠提示词 |
| square_hd 输出尺寸 | 1024×1024 | 2048×2048 | 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 下载图片并转存。
适用场景
系列插画
文章配图、绘本页面或课程插图需要同一画风时，每次用同一组参考图，只换提示词。
品牌视觉延展
把已有的品牌插画作为参考，生成新的主题画面；需要固定品牌色时再加 colors。
社媒与活动配图
同一活动的多张配图保持统一风格，用竖版或横版预设适配不同版位。
风格方向试稿
换一组参考图就能试另一种画风，适合在定稿前比较几个方向。
价格怎么算
按输出图片张数计费，每次请求 1 张；参考图张数、尺寸预设和 style_match 不影响单价。
当前单价以页面上方和价格页显示的实时价格为准。
用你的参考图试一张
在上方 Playground 上传参考图、写一句提示词，满意后用同样的参数调用 POST /v1/tasks。
需要比较不同模型和计费档位？查看全部模型实时价格
常见问题
Recraft V4 Styles 是做什么的？
先用 1–10 张参考图定下画风，再用一句提示词描述要画的内容，模型会按参考图的画风生成一张新图。参考图决定“怎么画”，提示词决定“画什么”。
必须上传参考图吗？最多几张？
必须。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 六种预设。本页示例用 square_hd，输出为 1024×1024。
和 Recraft V4 Styles Pro 有什么区别？
两者参数相同。Pro 的输出分辨率更高：同样用 square_hd，Styles 示例输出 1024×1024，Pro 示例输出 2048×2048。两者价格不同，以实时价格为准。
能指定配色和背景色吗？
可以通过 API 传 colors（RGB 对象数组）和 background_color（单个 RGB 对象），每个通道 0–255。在线 Playground 暂不显示这两个参数。
能保存一个风格反复使用吗？
目前不支持传入已保存的风格。每次请求都要带上参考图；想让一组图保持同一画风，就在每次请求里使用同一组参考图。
一次生成几张？输出是什么格式？
每次请求生成 1 张图片，从任务结果的 output[].url 下载。本页示例的输出是 WebP 图片。
怎么计费？
按输出图片张数计费；参考图张数、尺寸预设和 style_match 都不影响单价。当前价格见页面上方和价格页。
结果图片会保存多久？
结果链接有有效期，任务成功后请及时把图片转存到自己的存储。