Pika-Labs/Pika-H3-Flex

选用指南

AI 根据 README 整理 · 2026/10/30 08:21:42

使用方式

通过命令行工具 pika-h3-pro 使用，支持多种任务模式如 t2va、i2va、ref2va，并通过参数指定分辨率、宽高比、时长等。

查看 README 依据

export MODEL_REPO=Pika-Labs/Pika-H3-Flex export MODEL_REVISION=0ddf55ad7067ca1e76812253bd7b4600df87f759 ``` ```bash pika-h3-pro --task t2va --prompt-file examples/prompts/t2va.txt \ --model-repo "$MODEL_REPO" --revision "$MODEL_REVISION" \ --resolution 480p --aspect 16:9 --duration 5 --seed 42 --output outputs/sample.mp4 ``` Use `--task i2va --first-image first.png`, `--task l2va --last-image last.png`, or `--task fl2va --first-image first.png --last-image last.png` for endpoint conditioning. Ref2VA accepts ordered `--ref image:subject.png` inputs with a reference prompt: ```bash

pika-h3-pro --task ref2va --prompt-file examples/prompts/ref2va.txt \ --ref image:subject.png --model-repo "$MODEL_REPO" --revision "$MODEL_REVISION" \ --resolution 480p --duration 5 --output outputs/reference.mp4 ```

部署要求

需要 Python 3.12、NVIDIA GPU 及兼容驱动，系统需安装 git、patch、ffmpeg 和 C 编译器。下载模型约需 215.5 GB 存储空间。

查看 README 依据

cd Pika-H3-Flex ``` For pip installation, install system `git`, `patch`, `ffmpeg` and a C compiler with development headers first (for example, `build-essential` on Debian/Ubuntu). Triton needs the compiler at runtime. Docker and Conda recipes supply these prerequisites.

Use Python 3.12, an NVIDIA GPU and a compatible driver. Representative cases are tested on one H100 80GB per request; H200 and B300 remain untested. Longer clips and large reference sets can exceed GPU memory. Downloading both tasks acquired approximately 210 GB of base files plus 5.5 GB of adapters; allow additional space for dependencies and download staging. See [tested cases and memory measurements](docs/hardware.md).

已知限制

单次请求在单个 GPU 上运行，不支持多 GPU 分片加速。最长支持 15 秒视频，最大 12 个参考文件（9 图像、3 视频、3 音频）。

查看 README 依据

**GPU selection:** the current package runs one request on one GPU. The examples expose a single GPU with `--gpus 'device=0'`; exposing eight GPUs does not shard or accelerate a request. Multiple idle GPUs can run independent processes. Start qualification at 480p / 5 seconds. Multi-GPU inference within one request is not implemented in this package. ```bash python -m pip install -r requirements.txt python tools/apply_diffusers_patches.py python -m pip install --no-deps -e . pika-h3-pro --help ``` Alternatively, create the Conda environment, then install the package: ```bash

| Multimodal references | Prompt and ordered image/video references, optionally with audio references | Ref2VA / `ref2va` | Ref2VA accepts up to **9 images, 3 videos and 3 standalone audio clips**, with **12 reference files total**. At least one image or video is required. Each video or standalone audio clip must be **2–15 seconds**; combined video duration and combined standalone-audio duration must each be at most **15 seconds**. A video's embedded soundtrack stays with that video and does not count as an additional standalone audio file.