Krea

Krea 3

krea-3/text-to-image

支持文本生成与参考图编辑，原生 2K 输出，单次编辑约 8 秒，适合高频视觉迭代与素材复用

krea-3/text-to-image

试用 krea-3/text-to-image

输入

作品灵感

查看全部作品

输出

image

填写参数并生成，结果会显示在这里。

价格

krea-3/text-to-image 每张

单价	$0.036

定位简介

krea-3/text-to-image 是 Krea 面向文生图场景的模型线路，通过 HiAPI.ai 统一接口调用。它接受文本提示词生成图像，并提供方图、竖版与横版等多档尺寸预设，输出 PNG 或 JPEG。线路支持 berry 与 jam 两个变体，前者偏向画质、后者偏向速度，另可设置推理强度、负向提示词与固定随机种子，便于复现同一结果。适合需要按项目调节画质与出图速度平衡、并把生成批量接入自有流程的开发团队。

核心亮点

画质与速度可分档选择——variant 提供 berry 与 jam 两个选项，前者偏重质量、后者偏重速度，可按任务在两者间切换。
推理强度可调——reasoning_level 可选 low 或 medium，控制生成前对提示词的推理与扩写程度，medium 耗时更长。
输出尺寸与格式可控——内置方图、竖版 4:3/16:9 与横版 4:3/16:9 六种预设，最大 1024×1024，输出可选 PNG 或 JPEG。
支持固定种子复现——传入 seed 可让相同输入复现同一结果，便于调试提示词与做版本对照。

能力说明

文本提示词生成图像：以一段文本描述作为唯一必需输入，返回单张图像；prompt 最长 5000 字符，可容纳较完整的主体、风格与构图描述。

负向提示词排除元素：通过 negative_prompt（最长 1024 字符）指定不希望出现在画面中的内容，为画面控制增加一个维度。

六档尺寸预设与格式选择：按最终投放位置选择方形、竖版或横版预设，并直接输出 PNG 或 JPEG，减少后续转档步骤。

参数化结果复现：seed 与 reasoning_level 等参数固定后，同样的输入可稳定得到同样输出，适合建立可重复的生成基线。

适用场景

内容团队的配图批量生成——按栏目尺寸选择对应预设，一次调用产出一张配图，用于文章头图、社媒配图等需要稳定出图的位置。
设计开发者的提示词调优——固定 seed 后逐项调整 prompt 与负向提示词，对照输出差异，沉淀可复用的提示词模板。
竖版与横版物料的同源产出——用同一段描述切换 portrait 与 landscape 预设，得到适配移动端与网页端的同风格素材。
对出图速度敏感的原型验证——选用 jam 变体并调低推理强度，在方案早期快速拿到多版方向，再以 berry 产出精修版本。

限制与选型建议

仅支持文本提示词生成，不接收参考图，也不做局部编辑，需要图生图或区域性修改时应选择具备对应能力的模型。输出上限为 1024×1024，高分辨率成品需另行放大。negative_prompt 仅对 berry 变体生效，选 jam 时该参数不会起作用。每次调用返回一张图，多方案需多次请求。若任务要求严格复现某个既有角色或产品外观，纯文本描述难以保证一致性。

常见问题

查看全部常见问题 →

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）。

提交生成任务

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必填

当前固定值：krea-3/text-to-image

routestring可选

当前固定值：default

inputobject必填

krea-3/text-to-image 和线路 default 的业务参数对象，见下方参数表。

seedinteger可选min 0max 2147483647

固定随机种子，用于复现相同的生成结果；取整数，不提供时由服务端随机决定。

promptstring必填minLength 1maxLength 5000

待生成图像的文字描述，作为生成内容的提示词输入。

variantstring可选默认值: "berry"

生成变体档位，berry 侧重质量、jam 侧重速度；默认 berry。

可选项：berryjam

image_sizestring可选默认值: "square_hd"

输出尺寸预设，最大支持 1024×1024；默认 square_hd。

可选项：square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9

output_formatstring可选默认值: "png"

输出图像的格式；默认 png。

可选项：pngjpeg

negative_promptstring可选maxLength 1024

指定需要排除在图像之外的内容，仅 berry 变体生效。

reasoning_levelstring可选默认值: "medium"

控制生成前对提示词的推理与扩写程度，取值越高处理越深入、medium 相对更慢；默认 medium。

可选项：lowmedium

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": "krea-3/text-to-image",
  "input": {
    "prompt": "…",
    "variant": "berry",
    "image_size": "square_hd",
    "output_format": "png",
    "reasoning_level": "medium"
  }
}'

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: "krea-3/text-to-image",
    input: {
      "prompt": "…",
      "variant": "berry",
      "image_size": "square_hd",
      "output_format": "png",
      "reasoning_level": "medium"
    }
  }),
});
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": "krea-3/text-to-image",
        "input": {
          "prompt": "…",
          "variant": "berry",
          "image_size": "square_hd",
          "output_format": "png",
          "reasoning_level": "medium"
        }
    },
)
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"
    }
  }
}