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 错误：提示用户稍后重试，或减少并发视频生成请求数量。
• 任务失败：建议用户尝试更清晰的提示词，或更换输入图像。
• 超时：说明视频仍在生成中，用户可稍后重试。
• 可选技能更新提示：告知用户打印出的更新命令可择机运行。
• 必需技能更新提示：告知用户必须先运行打印出的更新命令，才能再次使用本技能。