HiAPI Seedance 2.0 Video_设计多媒体 skill-PHP中文网

HiAPI Seedance 2.0 Video

Polar Sponsor

爱发电赞助

.NET 9.0

立即下载

使用 HiAPI 的 Seedance‑2‑0 模型，通过 HiAPI 统一异步任务 API 生成视频。当用户请求使用 Seedance 2.0 或HiAPI 创建视频时使用。

HiAPI种子2.0 视频

功能概述

HiAPI种子2.0 视频是一项面向实际任务的技能，主要用于当用户想要通过HiAPI的种子2-0模式生成视频时使用此技能..；Node.js 18 或更新.；

核心要点

HIAPI API KEY 必须设置在环境中.；
HIAPI BASE URL。
它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。

使用与执行

使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。该技能适合需要稳定复用相关能力的场景，可作为自动化工作流的一部分，也便于后续检查、调整和扩展。从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。

结果检查与注意事项

实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；涉及批量任务时，还应保存进度，避免中断后重复操作。

HiAPI Seedance 2.0 视频生成

当用户希望通过 HiAPI 的 seedance-2-0 模型生成视频时，使用此技能。

运行要求

Node.js 18 或更高版本。
必须在环境中设置 HIAPI_API_KEY。
HIAPI_BASE_URL 为可选参数，默认值为 https://api.hiapi.ai。

重要链接：

获取 API 密钥：https://www.hiapi.ai/en/register
定价信息：https://www.hiapi.ai/en/pricing
文档：https://docs.hiapi.ai

切勿虚构视频结果。若 API 调用失败，请报告状态码、精简的错误消息，以及“错误指引”章节中建议的下一步操作。

生成视频

执行以下命令：

node scripts/hiapi-seedance-2-video.mjs 
  --prompt "黄金时刻拍摄的电影级海崖镜头" 
  --seconds 5 
  --resolution 720p 
  --ratio 16:9

如需图像生成视频（image-to-video），请传入公开的图片 URL 或 data URI：

node scripts/hiapi-seedance-2-video.mjs --prompt "产品图通过柔和的镜头运动变得生动起来" --input-reference "https://example.com/product.jpg"

支持的视频时长（单位：秒）：

任意介于 4 至 15 之间的整数

支持的分辨率：

480p
720p
1080p

支持的宽高比：

16:9
9:16
1:1
4:3
3:4
21:9
adaptive

媒体模式互斥，不可混用：

文生视频（text-to-video）：不提供任何媒体字段。
首帧图像生成视频（first-frame image-to-video）：使用 --first-frame-url，或沿用旧别名 --input-reference。
首帧+末帧图像生成视频（first+last-frame image-to-video）：同时提供 --first-frame-url 和 --last-frame-url。
多模态参考视频生成（multimodal reference video generation）：使用 --reference-image-url、--reference-video-url 和/或 --reference-audio-url。

请勿将首帧/末帧字段与参考图像/视频/音频字段混用。在多模态参考模式下，提示词中可要求某张参考图像作为首帧或末帧；但若需严格指定首帧与末帧身份，则应使用首帧+末帧模式。

参考素材限制：

reference_image_urls 与首帧/末帧图像合计最多 9 张图片。
reference_video_urls：最多 3 个视频；每个时长为 2–15 秒；总时长不超过 15 秒。CLI 要求为每个视频 URL 单独指定一个 --reference-video-duration 参数。
reference_audio_urls：最多 3 段音频；每段时长为 2–15 秒；总时长不超过 15 秒。CLI 要求为每个音频 URL 单独指定一个 --reference-audio-duration 参数。

该脚本将创建一个视频任务，轮询直至任务完成，在可能的情况下将生成的视频下载至 outputs/ 目录，并输出包含已保存文件路径或远程 URL 的 JSON 结果。

API 接口规范

本技能调用以下接口：

POST /v1/tasks
GET /v1/tasks/{taskId}

请求体如下：

{
  "model": "seedance-2-0",
  "input": {
    "prompt": "...",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "first_frame_url": "https://example.com/photo.jpg",
    "last_frame_url": "https://example.com/end.jpg",
    "reference_image_urls": ["asset://image-1"],
    "reference_video_urls": ["asset://video-1"],
    "reference_audio_urls": ["asset://audio-1"],
    "return_last_frame": false,
    "web_search": false,
    "nsfw_checker": false,
    "generate_audio": true,
    "seed": 12345
  }
}

first_frame_url 为可选字段。CLI 仍兼容旧别名 --input-reference，并将其映射为 input.first_frame_url。请勿在同一请求中同时包含 first/last-frame 字段与 reference_*_urls 字段。generate_audio 默认不显式出现在请求中——API 默认值为 true（启用音频）；如需禁用，请传入 --no-audio（或 --no-generate-audio）；如需强制启用，请传入 --generate-audio。seed 是一个可选整数，取值范围为 0 至 2147483647，用于实现可复现的生成结果；仅当明确传入 --seed 参数时才包含在请求中。

更多详情请参阅 references/api.md 和 references/output.md。

检查配置

执行以下命令：

node scripts/check-config.mjs

仅当您希望验证当前配置的密钥能否成功访问 HiAPI 计费接口时，才使用 --live 参数。

错误指引

HIAPI_API_KEY 缺失：提示用户前往 https://www.hiapi.ai/en/register 创建或复制 API 密钥，并将其导出至环境变量。
HTTP 401 或 403 错误：提示用户核对 HiAPI API 密钥是否正确。
HTTP 402 错误、含配额相关文本的 HTTP 403 错误、余额不足、积分不足、配额超限或支付失败等错误：提示用户前往 https://www.hiapi.ai/en/dashboard 充值或检查账单，并查阅 https://www.hiapi.ai/en/pricing 了解定价详情。
HTTP 400 错误：提示用户检查视频时长、分辨率、宽高比、媒体模式、参考素材数量，以及参考音频/视频的时长是否符合要求。
HTTP 429 错误：提示用户稍后重试，或减少并发视频生成请求数量。
任务失败：建议用户尝试更清晰的提示词，或更换输入图像。
超时：说明视频仍在生成中，用户可稍后重试。
可选技能更新提示：告知用户打印出的更新命令可择机运行。
必需技能更新提示：告知用户必须先运行打印出的更新命令，才能再次使用本技能。