PixVerse V6 图生视频 API 怎么用

TL;DR

它是什么：图生视频模型。给一张首帧图和一段运动描述，输出 1–15 秒的连贯视频。打开 PixVerse V6 图生视频模型页上传图片就能试，新用户注册送 200 积分。
多少钱：按提交的整数秒乘以所选分辨率的每秒单价计费。360p 每秒 $0.036，720p $0.0645，1080p $0.129；720p 无声 5 秒 $0.3225，开音频 $0.43，$10 能出约 31 条 720p 无声 5 秒。
最快怎么调：模型页传首帧图、写运动、选时长和分辨率就能出片；接进产品走 POST https://api.hiapi.ai/v1/tasks，model 填 pixverse-v6/image-to-video，input 放 image_url、prompt、duration、resolution。

PixVerse V6 图生视频是什么

它把静止画面变成连贯运动。image_url 决定第一帧，成片的画幅、构图、光影、人物位置全部跟着这张图走；prompt 只负责说明哪里动、怎么动——镜头推进、人物抬手、雨往下落、雾气飘移。时长 1–15 秒，分辨率 360p 到 1080p，需要声音就打开 generate_audio，同一条交付里带上背景音乐、音效和对白。

和文生视频最大的区别在输入。文生视频从零造一个世界，提示词要写场景、主体、光线和镜头；图生视频的世界已经画好了，提示词再写场景会和首帧打架，成片要么几乎不动，要么融化变形。写运动、不写风景，是第一条规矩。

第二个区别是没有 aspect_ratio 字段——成片形状由首帧图决定，要竖屏就传一张竖图。

在线试用：4 步出第一条

打开 PixVerse V6 图生视频模型页，注册拿到 200 积分。
上传首帧图。想要竖屏就传竖版图，横屏同理，图的形状就是成片的形状。
提示词框里写运动和镜头，中文英文都行，比如下面这条雪夜灯笼。
选 duration 和 resolution，先按 5 秒、720p 试，需要环境声就打开音频，提交。

200 积分够出一条 360p 无声 5 秒（180 积分），想直接跑 720p 就先充 $10。

大雪持续落下，红灯笼随风轻摆，寒气从结冰的池塘上飘过，镜头缓慢推进，安静的冬夜环境声。

API 接入：4 步跑通

在控制台创建 API Key，放进请求头 Authorization: Bearer YOUR_API_KEY。
POST https://api.hiapi.ai/v1/tasks，model 写 pixverse-v6/image-to-video，input 放 image_url 和 prompt。
从返回里取 data.taskId，轮询 GET /v1/tasks/{taskId}，或传 callback 接收完成通知。
data.status 变成 success 后，从 data.output[0].url 下载 MP4，马上转存到自己的存储。

image_url 必须是公网能访问的图片地址，平台在服务端自己去取，localhost 和内网桶地址取不到。模型 ID 里的斜杠是名字的一部分，不能换成横线。

可运行的 curl

curl -s -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "pixverse-v6/image-to-video",
    "input": {
      "image_url": "https://static.hiapi.ai/admin-assets/pixverse-v6/2026/10/20/1792467204710-af906b41b42e1aeb-i2v-snow-lantern-courtyard-input.jpg",
      "prompt": "大雪持续落下，红灯笼随风轻摆，寒气从结冰的池塘上飘过，镜头缓慢推进，安静的冬夜环境声。",
      "duration": 5,
      "resolution": "720p",
      "generate_audio": true
    }
  }'

返回里的任务 ID 在 data.taskId：

{"code":200,"data":{"taskId":"YOUR_TASK_ID"},"message":"success"}

拿这个 ID 查状态：

curl -s https://api.hiapi.ai/v1/tasks/YOUR_TASK_ID \
  -H "Authorization: Bearer YOUR_API_KEY"

data.status 到 success 时，视频地址在 data.output[0].url；到 fail 时错误信息也在返回体里。这个地址是临时链接，下载后存到自己的桶里，别直接当 CDN 用。

Python 版：创建、轮询、下载一次写完

import time
import requests

BASE = "https://api.hiapi.ai/v1/tasks"
HEADERS = {"Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json"}

payload = {
    "model": "pixverse-v6/image-to-video",
    "input": {
        "image_url": "https://static.hiapi.ai/admin-assets/pixverse-v6/2026/10/20/1792467204710-af906b41b42e1aeb-i2v-snow-lantern-courtyard-input.jpg",
        "prompt": "大雪持续落下，红灯笼随风轻摆，寒气从结冰的池塘上飘过，镜头缓慢推进，安静的冬夜环境声。",
        "duration": 5,
        "resolution": "720p",
        "generate_audio": True,
    },
}

r = requests.post(BASE, headers=HEADERS, json=payload, timeout=60)
r.raise_for_status()
task_id = r.json()["data"]["taskId"]

while True:
    data = requests.get(f"{BASE}/{task_id}", headers=HEADERS, timeout=30).json()["data"]
    if data["status"] == "success":
        url = data["output"][0]["url"]
        break
    if data["status"] == "fail":
        raise RuntimeError(data.get("error"))
    time.sleep(5)

with open("out.mp4", "wb") as f:
    f.write(requests.get(url, timeout=120).content)
print("saved out.mp4")

单次查询报错就等几秒重查同一个 task_id，不要重新提交——重新提交会再跑一次渲染、再扣一次费。

参数表

字段	必填	取值	说明
`prompt`	是	1–2,048 字节	只写运动、镜头和氛围；一个中文字符占 3 字节
`image_url`	是	公网图片 URL	单个字符串，首帧图，成片画幅跟随它
`duration`	否	1–15 的整数秒	默认 5，必须传数字
`resolution`	否	`360p` / `540p` / `720p` / `1080p`	默认 `720p`
`generate_audio`	否	`true` / `false`	默认 `false`，开启后带背景音乐、音效与对白
`negative_prompt`	否	≤ 2,048 字节	写想避开的内容，人脸和手部问题最常用
`style`	否	`anime` / `3d_animation` / `clay` / `comic` / `cyberpunk`	预设画风；图生视频里首帧决定外观，想换风格先把首帧做成那个风格
`seed`	否	整数	固定种子复现同一条，改提示词对比最方便

表里没有的字段会被直接拒绝，报错会点名是哪个。首帧图放 image_url，镜头运动写进 prompt。

竖屏怎么出

传一张竖版首帧。9:16 的图进来，出来就是 9:16 的片子——整条请求里没有画幅参数，形状完全由图片决定。裁剪或生成素材时就把比例定好，别等成片出来再补黑边。横版、方图同理，需要什么形状就传什么形状的首帧。

上线前注意 3 件事

回调加轮询兜底。 请求体加 "callback": {"url": "https://yourapp.com/webhook", "when": "final"}，任务进终态会通知你；通知可能丢，再配一个定时 GET /v1/tasks/{taskId} 补偿，按 taskId 去重。
resolution 显式写。 不传按 720p 跑，账单也按 720p 算；批量生成时把 360p、540p 写清楚，别依赖默认值。
时长决定账单。 费用按提交的整数秒计算，秒数直接放大总价：15 秒 1080p 无声 $1.935，够出 6 条 5 秒 720p。先用 5 秒定稿，再拉长。