PixVerse

PixVerse V6

pixverse-v6/image-to-video

PixVerse 旗舰视频生成模型，单模型覆盖文生视频与图生视频，支持精确相机控制、角色表演与参考图融合，面向成片级制作

pixverse-v6/image-to-video pixverse-v6/text-to-video

价格

pixverse-v6/image-to-video 每秒

规格	360P	540P	720P	1080P
Sound Off	$0.036	$0.050	$0.0645	$0.129
Sound On	$0.050	$0.0645	$0.086	$0.1645

定位简介

PixVerse V6 图生视频模型将静态图像转为动态视频，面向需要把产品图、角色图或分镜画面快速制成可商用视频素材的开发者与创作团队。模型以首帧图像锚定画面构图与比例，通过提示词描述运动与氛围，并可选择风格预设、分辨率与时长。输出为视频文件，适合接入广告制作、短剧分镜与批量素材动画化的自动化管线。

核心亮点

首帧图像锚定构图与画幅比例——输出视频沿用输入图像的长宽比，减少不同素材间的裁切与适配成本。
可选原生音画同步生成——开启后随视频生成背景音乐、音效与对白，省去单独配音配乐环节。
风格预设与反向提示词双重控制——可套用动漫、黏土、赛博朋克等预设风格，并用反向提示词排除不想要的内容。
种子可复现同一条结果——固定 seed 与提示词可稳定复现相同输出，便于批量生成与版本对比。

能力说明

图生视频合成：以公开图片 URL 为首帧，配合运动与氛围提示词生成视频，适合把已有视觉素材直接转化为动态内容。

灵活时长与分辨率：时长可在 1 至 15 秒间设定，分辨率支持 360p、540p、720p、1080p，便于按投放渠道与预览需求匹配规格。

音画同步生成：可开启音频生成，随视频一并产出背景音乐、音效与对白，降低后期音轨制作的工作量。

风格预设与反向提示词：内置动漫、3D 动画、黏土、漫画、赛博朋克五种风格预设，并支持反向提示词规避不需要的画面元素。

可复现的随机种子：通过固定 seed 与提示词复现同一结果，方便在批量任务中保持一致性或做对照实验。

适用场景

营销团队将产品图转为短视频——以商品图为首帧生成带运动与氛围的短片，可直接用于信息流广告或电商详情页的动效素材。
短剧与分镜团队将构图稿动画化——把分镜画面转为动态镜头，用于前期预览或直接作为成片片段，加速叙事节奏验证。
角色与品牌素材的批量动画化——固定种子与风格预设，对系列角色图或品牌视觉做统一风格的视频化产出，用于社交媒体内容排期。
开发者接入自动化视频生成管线——通过统一接口按任务提交图片与提示词，批量产出视频资产，供内容平台或创作工具调用。

限制与选型建议

该模型仅支持图生视频，需要提供首帧图像，无法纯文本直接生成；时长上限 15 秒，不适合需要长镜头的连续叙事。风格预设仅五种，且公开信息缺少独立的第三方画质与运动稳定性评测，选型时应以自身素材实测为准。按输出秒数计费，成本随成片时长线性增长，长视频或大批量任务需提前评估预算。若需要更长时长或多镜头叙事，建议搭配同族文生视频线路或分段生成后拼接使用。

常见问题

查看全部常见问题 →

PixVerse V6 图生视频是什么？

它是 PixVerse V6 的图生视频版本：上传一张图片作为首帧，再用提示词描述要添加的动作、镜头和氛围，生成 1 到 15 秒、360p 到 1080p 的视频，可选同步音频和风格预设。
输出视频的画面比例由什么决定？

由 image_url 这张首帧图的比例决定，所以图生视频没有 aspect_ratio 参数。需要竖屏就上传竖版图，需要 16:9 就上传横版图。
提示词应该怎么写？

只写希望发生的变化：主体动作、镜头运动、环境变化和声音，不必复述图片里已经有的内容。写清楚哪些东西要保持不动，例如“镜头保持不动”“背景不变”。
对输入图片有什么要求？

image_url 必须是公网可以直接访问的图片地址，Playground 里也可以直接上传。主体清晰、构图完整、留有动作空间的图片更容易得到稳定的运动。

提交生成任务

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

当前固定值：pixverse-v6/image-to-video

routestring可选

当前固定值：default

inputobject必填

pixverse-v6/image-to-video 和线路 default 的业务参数对象，见下方参数表。

seedinteger可选

随机种子，用于复现生成结果；相同的种子与提示词可得到相同的输出。

stylestring可选

可选的视觉风格预设字符串；省略时使用模型自然风格。

可选项：anime3d_animationclaycomiccyberpunk

promptstring必填minLength 1maxLength 2048

描述要为图像添加的运动与氛围，最多 2048 个 UTF-8 字节（中文字符每个占 3 字节）。

durationinteger可选默认值: 5min 1max 15

视频时长（秒），取值范围 1 到 15，默认 5。

image_urlstring必填

用作首帧的公开可访问图片 URL，输出视频将沿用该图片的宽高比。

resolutionstring可选默认值: "720p"

输出视频分辨率，默认 720p。

可选项：360p540p720p1080p

generate_audioboolean可选默认值: false

是否随视频生成背景音乐、音效与对白，默认 false。

negative_promptstring可选

指定视频中要避免出现的内容，最多 2048 个 UTF-8 字节（中文字符每个占 3 字节）。

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": "pixverse-v6/image-to-video",
  "input": {
    "prompt": "…",
    "duration": 5,
    "image_url": "…",
    "resolution": "720p",
    "generate_audio": false
  }
}'

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: "pixverse-v6/image-to-video",
    input: {
      "prompt": "…",
      "duration": 5,
      "image_url": "…",
      "resolution": "720p",
      "generate_audio": false
    }
  }),
});
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": "pixverse-v6/image-to-video",
        "input": {
          "prompt": "…",
          "duration": 5,
          "image_url": "…",
          "resolution": "720p",
          "generate_audio": False
        }
    },
)
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"
    }
  }
}