跳转到内容
HiAPI Docs
HiAPI
在线试用 获取 API Key
中文
English 中文

Krea 2 Medium Turbo Text to Image API

POST Base URL: https://api.hiapi.ai /v1/tasks

图片、视频和音频模型通过统一异步接口 POST /v1/tasks 调用，区别只在 input 字段（见下方 input 参数）。

模型概览

模型名称 krea-2-medium-turbo
类型 图像生成（文生图）
接口 POST /v1/tasks
价格 见 HiAPI 定价

Krea 2 Medium Turbo：快速文生图，支持含 2.35:1 宽银幕在内的 8 种比例、4 档创意度和可复现的种子。

生产建议

生产建议
  • 生产环境建议在请求体顶层传 callback.url，任务进入终态时 HiAPI 会通知你的服务。
  • GET /v1/tasks/:id 更适合本地调试、低频任务或回调丢失时的兜底对账。
  • 结果地址会过期，任务成功后请尽快把图片转存到自己的存储。

适用场景

概念草图与快速迭代

出图快，适合反复调整提示词。

promptcreativity
电影感与横幅

2.35:1 宽银幕适合电影感构图和横幅。

aspect_ratio
可复现迭代

固定种子对比提示词和创意度的改动。

seedcreativity

请求参数

model string 必填

固定填 krea-2-medium-turbo。

示例 krea-2-medium-turbo
input object 必填

业务参数对象。

prompt string 必填

图片描述，1–5000 个字符。

aspect_ratio enum 可选

画面比例，含 2.35:1 宽银幕。

默认 1:1 可选值: 1:14:33:216:92.35:14:52:39:16
creativity enum 可选

对提示词的发挥程度：越低越贴近描述，越高越有创意、也可能偏离描述。

默认 low 可选值: rawlowmediumhigh
seed integer 可选

随机种子，可选。不传则随机；固定种子和其他参数可复现结果。

callback object 可选

可选回调配置。设置后，任务进入终态时 HiAPI 会通知你的服务。

url string 必填

设置 callback 时必填，接收任务终态通知的 HTTPS 地址。

示例 https://your-domain.com/hiapi/callback
when enum 可选

回调触发时机，使用 final。

默认 final 可选值: final

用例示例

宽银幕灯塔

2.35:1 电影感构图，creativity 使用默认 low。

请求体
{
  "model": "krea-2-medium-turbo",
  "input": {
    "prompt": "Cinematic wide shot of a lone lighthouse on a rocky coast at blue hour, warm light in the lantern room, waves breaking on the rocks, light mist over the sea",
    "aspect_ratio": "2.35:1",
    "creativity": "low"
  }
}

获取结果

  1. 接口会立即返回 taskId，不等待生成完成。
  2. 生产环境建议等待 callback.url 收到终态通知；本地调试可轮询 GET /v1/tasks/:id。
  3. status=success 时，从 output[].url 下载图片。
  4. status=fail 时，根据返回的错误修正请求，不要原样重试无效参数。

常见问题

Krea 2 Medium Turbo 适合做什么？

它能根据一段文字描述很快生成高保真图片，适合需要快速出图、反复调整提示词的场景，例如概念草图、社媒配图和电影感画面。

支持哪些画面比例？

aspect_ratio 可选 1:1（默认）、4:3、3:2、16:9、2.35:1、4:5、2:3、9:16 共 8 种。

2.35:1 比例适合什么画面？

2.35:1 是常见的宽银幕电影画幅，适合电影感场景、网站横幅和视频封面这类超宽构图。

creativity（创意度）有什么作用？

creativity 控制模型对提示词的发挥程度，可选 raw、low、medium、high。档位越低越贴近描述，越高画面越有创意，但也可能偏离描述。

creativity 默认是哪一档？

在 HiAPI 上默认是 low，结果更贴近提示词。想要更多变化时可以改成 medium 或 high。

seed（种子）怎么用？

seed 是可选的整数。不传时每次随机；固定 seed 和其他参数，可以复现同一结果，方便对比提示词或创意度的改动。

一次能生成几张？

每次请求生成 1 张图片，需要多张时分别提交多个任务。

提示词有长度限制吗？

prompt 必填，长度 1–5000 个字符。

需要上传参考图吗？

不需要，这是纯文生图模型，只用文字描述生成图片。风格参考图、预设风格和情绪板目前未开放。

怎么计费？

按输出图片张数计费，每次请求 1 张。当前单价以页面上的实时价格为准。

如何获取生成结果？

调用 POST /v1/tasks 后会立即返回 taskId。生产环境建议设置 callback.url 接收完成通知，调试时可以轮询 GET /v1/tasks/:id；任务成功后从 output 中的图片地址下载。

有内容安全检查吗？

有，每次生成都会开启安全检查，不符合内容规范的请求可能失败。

下一步