mcpField
A
aliyun-pixverse-generation

aliyun-pixverse-generation

github.com/cinience创意与媒体39659 次安装11 周前更新
代码仓库

关于 aliyun-pixverse-generation

aliyun-pixverse-generation 是用于在 Alibaba Cloud Model Studio 中准备 PixVerse 系列视频生成请求的技能,支持文本、图像、帧间过渡和多图参考,并通过异步任务提交与轮询获取结果。

主要功能

  1. 01准备 PixVerse 视频请求
  2. 02支持文本生成视频
  3. 03将首帧图像制作成动画
  4. 04生成两帧之间的过渡
  5. 05用多张图保持一致性

适用场景

  1. 01根据文本提示生成视频
  2. 02让提供的首帧图像动起来
  3. 03制作两帧之间的视频过渡
  4. 04通过参考图保持角色或风格一致

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/cinience/alicloud-skills --skill aliyun-pixverse-generation

安装后在 Claude Code 中输入/aliyun-pixverse-generation确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

agents/
openai.yaml
references/
sources.md
scripts/
prepare_aishi_request.py

详细介绍

类别:provider

Model Studio Aishi 视频生成

验证

mkdir -p output/aliyun-pixverse-generation
python -m py_compile skills/ai/video/aliyun-pixverse-generation/scripts/prepare_aishi_request.py && echo "py_compile_ok" > output/aliyun-pixverse-generation/validate.txt

通过标准:命令以状态码 0 退出,并生成 output/aliyun-pixverse-generation/validate.txt。

输出与证据

  • 将标准化请求负载、所选模型变体和任务轮询快照保存到 output/aliyun-pixverse-generation/ 下。
  • 记录区域、分辨率/尺寸、时长,以及是否启用了音频生成。

当用户明确需要使用非 Wan PixVerse 系列进行视频生成时,使用 Aishi。

关键模型名称

使用以下精确模型字符串之一:

  • pixverse/pixverse-v5.6-t2v
  • pixverse/pixverse-v5.6-it2v
  • pixverse/pixverse-v5.6-kf2v
  • pixverse/pixverse-v5.6-r2v

选择指南:

  • 文本生成视频时使用 pixverse/pixverse-v5.6-t2v。
  • 使用首帧图像生成视频时使用 pixverse/pixverse-v5.6-it2v。
  • 生成首帧到末帧的转场时使用 pixverse/pixverse-v5.6-kf2v。
  • 需要多张图像保持角色/风格一致性时使用 pixverse/pixverse-v5.6-r2v。

前置条件

  • 此系列目前仅支持中国大陆(北京)。
  • 安装 SDK 或直接调用 HTTP:
python3 -m venv .venv
. .venv/bin/activate
python -m pip install dashscope
  • 在环境中设置 DASHSCOPE_API_KEY,或将 dashscope_api_key 添加到 ~/.alibabacloud/credentials。

标准化接口(video.generate)

请求
  • model(字符串,必填)
  • prompt(字符串;it2v 可选,其他变体必填)
  • media(array,可选)
  • size(字符串,可选):直接指定像素尺寸,例如 1280*720,用于 t2v 和 r2v
  • resolution(字符串,可选):360P/540P/720P/1080P,用于 it2v 和 kf2v
  • duration(整数,必填):5/8/10,但 1080P 仅支持 5/8
  • audio(布尔值,可选)
  • watermark(布尔值,可选)
  • seed(整数,可选)
  • 响应
    • task_id(字符串)
    • task_status(字符串)
    • video_url(字符串,任务完成时返回)

    端点与执行模式

    • 提交任务:POST https://dashscope.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis
    • 轮询任务:GET https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}
    • HTTP 调用仅支持异步模式,且必须设置请求头 X-DashScope-Async: enable。

    快速开始

    文本生成视频:

    python skills/ai/video/aliyun-pixverse-generation/scripts/prepare_aishi_request.py \
      --model pixverse/pixverse-v5.6-t2v \
      --prompt "A compact robot walks through a rainy neon alley." \
      --size 1280*720 \
      --duration 5
    

    图像生成视频:

    python skills/ai/video/aliyun-pixverse-generation/scripts/prepare_aishi_request.py \
      --model pixverse/pixverse-v5.6-it2v \
      --prompt "The turtle swims slowly as the camera rises." \
      --media image_url=https://example.com/turtle.webp \
      --resolution 720P \
      --duration 5
    

    操作指南

    • t2v 和 r2v 使用 size;it2v 和 kf2v 使用 resolution。
    • 对于 kf2v,请恰好提供一个 first_frame 和一个 last_frame。
    • 对于 r2v,最多可以传入 7 张参考图像。
    • Aishi 会先返回任务 ID;不要将初始响应视为最终视频结果。

    输出位置

    • 默认输出:output/aliyun-pixverse-generation/request.json
    • 使用 OUTPUT_DIR 覆盖基础目录。

    参考资料

    • references/sources.md

评论

支持 Markdown