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

Creatify Boreal API

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

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

模型概览

模型名称 creatify-boreal
类型 视频生成（文生视频）
接口 POST /v1/tasks
价格 见 HiAPI 定价

Creatify Boreal：一段提示词生成带原生配音和音效的商品、UGC 与口播视频，可加参考图或音频，1–20 秒，720p、1080p 或 2K，5 种画面比例加自动。

生产建议

生产环境建议
  • 生产环境建议在请求体顶层传 callback.url，让 HiAPI 在任务进入终态时主动通知你的服务，减少无效轮询。
  • GET /v1/tasks/:id 更适合本地调试、低频任务，或作为回调失败后的补偿查询。
  • callback.when 当前建议固定为 final；success 和 fail 都可能触发终态通知，你的服务端需要按 taskId 做幂等处理。

适用场景

商品视频

传一张商品图，让镜头和光线动起来，并配上一句旁白。

image_urlprompt
UGC 与口播

在 [SPEECH] 中写台词，生成对着镜头说话的竖屏短视频。

promptaspect_ratio
音频驱动讲解

提供讲解员图和一段旁白音频，人物按音频开口说话。

image_urlaudio_urlduration

请求参数

model string 必填

固定填 creatify-boreal。

示例 creatify-boreal
input object 必填

业务参数对象；Creatify Boreal 的模型专属配置都放在这里。

prompt string 必填

描述画面、台词、声音和屏幕文字，长度 1–5000 个字符。按 [VISUAL]、[SPEECH]、[SOUNDS]、[TEXT] 分段效果更好；建议使用英文提示词。

image_url string 可选

可选，参考图的 http(s) 地址。aspect_ratio 为 auto 时视频跟随参考图比例；指定比例时会居中裁切参考图。

audio_url string 可选

可选，旁白、对白或配乐的 http(s) 地址。输出只保留前 duration 秒；音频较短时用静音补齐。

negative_prompt string 可选

不希望出现的内容或瑕疵，最长 2000 个字符。

默认 ""
resolution enum 可选

输出档位：720p、1080p 或 2k（16:9 和 9:16 长边 2016 像素；1:1、4:3、3:4 为 1440p 档）。

默认 720p 可选值: 720p1080p2k
aspect_ratio enum 可选

auto 跟随参考图比例，没有参考图时为 16:9。

默认 auto 可选值: auto16:99:161:14:33:4
duration integer 可选

视频时长，单位为秒，取 1–20 的整数；按请求的时长计费。

默认 10
manifest_disclosure boolean 可选

在视频上加可见的 AI 生成标识。

默认 false
callback object 可选

可选回调配置；设置后任务进入终态时 HiAPI 会主动通知你的服务，减少轮询。

url string 必填

传入 callback 时必填；接收任务终态通知的 HTTPS 地址。

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

回调触发时机；当前建议固定为 final。

默认 final 可选值: final

用例示例

竖屏 UGC 口播

文生视频：8 秒、720p、9:16。

请求体
{
  "model": "creatify-boreal",
  "input": {
    "prompt": "[VISUAL] Vertical selfie video: a young woman in a bright bedroom holds up a pastel lip balm. [SPEECH] \"Okay, this is the only lip balm that survived my winter.\" [SOUNDS] Natural room tone.",
    "resolution": "720p",
    "aspect_ratio": "9:16",
    "duration": 8
  }
}
商品图转视频

参考图生视频：5 秒、1080p，比例跟随参考图。

请求体
{
  "model": "creatify-boreal",
  "input": {
    "prompt": "The sneaker slowly rotates on the concrete floor as soft studio light sweeps across it; a calm voice says: \"Built for the long run.\"",
    "image_url": "https://example.com/sneaker.png",
    "resolution": "1080p",
    "duration": 5
  }
}
音频驱动讲解员

参考图 + 旁白音频：12 秒、720p、9:16。

请求体
{
  "model": "creatify-boreal",
  "input": {
    "prompt": "The presenter talks warmly to the camera, natural gestures, lip-synced to the narration.",
    "image_url": "https://example.com/presenter.png",
    "audio_url": "https://example.com/narration.mp3",
    "aspect_ratio": "9:16",
    "duration": 12
  }
}

获取结果

  1. 提交成功后立即返回 taskId（不等待生成完成）。
  2. 生产环境优先等待 callback.url 收到终态通知；本地调试时可轮询 GET /v1/tasks/:id。
  3. status=success 后，从返回的 output[].url 下载生成的视频。
  4. 如果 status=fail，按返回的错误信息修正请求，不要盲目重试同一个无效请求。

常见问题

视频带声音吗?

带。模型会生成与画面匹配的配音和音效；提供 audio_url 时使用你的音频。

提示词应该怎么写?

按 [VISUAL]、[SPEECH]、[SOUNDS]、[TEXT] 分段描述画面、台词、声音和屏幕文字，建议使用英文。

音频比时长长怎么办?

输出只保留音频的前 duration 秒；需要完整旁白时把 duration 设为不小于音频长度。

如何计费?

按请求的时长（秒）和分辨率计费，以 HiAPI 定价页的实时价格为准。 查看价格

下一步