Krea 3 Text to Image API
https://api.hiapi.ai /v1/tasks 图片、视频和音频模型通过统一异步接口 POST /v1/tasks 调用，区别只在 input 字段（见下方 input 参数）。
模型概览
| 模型名称 | krea-3/text-to-image |
|---|---|
| 类型 | 图像生成（文生图） |
| 接口 | POST /v1/tasks |
| 价格 | 见 HiAPI 定价 |
Krea 3：出图前先推理提示词，berry / jam 两个变体（同价），支持 6 种最大 1024 × 1024 的尺寸、负面提示词（仅 berry）和 seed。
生产建议
- 生产环境建议在请求体顶层传 callback.url，让 HiAPI 在任务进入终态时主动通知你的服务，减少无效轮询。
- GET /v1/tasks/:id 更适合本地调试、低频任务，或作为回调失败后的补偿查询。
- 产物 URL 有有效期，拿到结果后请及时转存到自己的存储。
适用场景
材质、光线逐项描述，固定 seed 批量出同风格商品图。
promptseed短提示词配合 reasoning_level=medium，让模型补全画面。
promptreasoning_level同一提示词分别用 berry 和 jam 各跑一次，得到两种构图再挑选。
variantseed请求参数
model string 必填 固定填 krea-3/text-to-image。
input object 必填 业务参数对象。
prompt string 必填 图片描述，1–5000 个字符。
image_size enum 可选 输出尺寸预设：square_hd 1024×1024、square 512×512、portrait_4_3 768×1024、portrait_16_9 576×1024、landscape_4_3 1024×768、landscape_16_9 1024×576。不支持 auto 和自定义宽高。
variant enum 可选 变体：berry（默认）或 jam，同价，除 negative_prompt 仅 berry 生效外参数相同；同 seed 下两者构图不同。
reasoning_level enum 可选 出图前对提示词的推理深度，medium 更慢但更完整。
negative_prompt string 可选 不希望出现的内容，最长 1024 个字符，仅 berry 生效。
seed integer 可选 随机种子，0–2147483647，用于复现结果。
output_format enum 可选 输出图片格式。
callback object 可选 可选回调配置；设置后任务进入终态时 HiAPI 会主动通知你的服务，减少轮询。
url string 必填 传入 callback 时必填；接收任务终态通知的 HTTPS 地址。
when enum 可选 回调触发时机；当前建议固定为 final。
用例示例
square_hd、berry、reasoning medium、固定 seed。
{
"model": "krea-3/text-to-image",
"input": {
"prompt": "Studio product photograph of a frosted glass perfume bottle with a brushed brass cap standing on a block of travertine, hard afternoon sunlight casting a long palm-leaf shadow across a warm beige wall, crisp reflections, high-end editorial look",
"image_size": "square_hd",
"variant": "berry",
"reasoning_level": "medium",
"seed": 31017
}
}jam + reasoning low，输出 JPEG。
{
"model": "krea-3/text-to-image",
"input": {
"prompt": "Cinematic film still of a lone astronaut walking across red sand dunes toward a crashed silver capsule, two moons low on the horizon",
"image_size": "landscape_16_9",
"variant": "jam",
"reasoning_level": "low",
"output_format": "jpeg"
}
}berry 下用 negative_prompt 排除人物与文字。
{
"model": "krea-3/text-to-image",
"input": {
"prompt": "A winding forest path through tall birch trees in autumn, golden leaves, soft fog, morning sun rays",
"image_size": "landscape_4_3",
"variant": "berry",
"negative_prompt": "people, animals, text, watermark"
}
}获取结果
- 提交成功后立即返回 taskId（不等待生成完成）。
- 生产环境优先等待 callback.url 收到终态通知；本地调试时可轮询 GET /v1/tasks/:id。
- status=success 后，从返回的 output[].url 下载图片。
- 如果 status=fail，按返回的错误信息修正请求，不要盲目重试同一个无效请求。
常见问题
Krea 3 适合做什么？
适合写实摄影、人像、产品图、美食、建筑空间、插画和概念设计，也能出带标题文字的海报。短提示词也能得到完整画面，适合快速探索方向。
berry 和 jam 有什么区别？
两者是同一模型的两个变体，大部分参数相同（negative_prompt 只对 berry 生效）：Krea 把 berry 定位为质量优先、jam 为速度优先，两者同价。通过 input.variant 切换，默认 berry。实际对比中，同 seed 下两者构图和色调不同、画质相当，可以都试一次再选。
reasoning_level 是什么？该选哪个？
它控制模型在出图前花多少功夫理解和扩写提示词，可选 low 和 medium（默认）。提示词很短或很抽象时用 medium；提示词已经写得很具体、想要更快时用 low。
支持哪些尺寸？
image_size 支持 6 种：square_hd（1024 × 1024，默认）、square（512 × 512）、portrait_4_3（768 × 1024）、portrait_16_9（576 × 1024）、landscape_4_3（1024 × 768）、landscape_16_9（1024 × 576）。
能输出 2K 或自定义宽高吗？
不能。本页提供的是 1K 规格，不支持 auto 和自定义宽高，传入会直接返回参数错误，不会扣费。
怎么计费？
按成功生成的图片张数计费，6 种尺寸同价，berry 与 jam 同价。具体单价以页面实时价格为准；参数校验失败的请求不扣费。
一次能生成几张？
每次请求生成 1 张。需要多张时提交多个任务，或用不同 seed 重跑。
负面提示词怎么用？
把不希望出现的元素写进 negative_prompt，例如 people, text, watermark，最长 1024 个字符。它只对 berry 生效：选 jam 时 Playground 会隐藏该项、不再提交；通过 API 给 jam 传也不会生效。
怎样得到可复现的结果？
传入固定的 seed（0–2147483647），并保持提示词、尺寸、variant 和 reasoning_level 不变。做系列图时只改一处描述即可。
画面里的文字准确吗？
短标题通常比较准确。把文字放进引号逐字写出，并说明位置和字体风格；文字较多时建议用 berry 搭配 reasoning medium。
输出是什么格式？
output_format 可选 png（默认）或 jpeg。任务成功后从结果的 output[].url 下载图片，链接有有效期，请及时转存。
需要上传参考图吗？
不需要，这是纯文生图模型，只接收文字描述。
同一个 seed 换成 jam，会得到同一张图吗？
不会。seed 只在同一个变体内复现结果；berry 和 jam 用同一 seed 会给出不同的构图和色调。想对比两个变体时，可以把它们当成两种方案各跑一次。