GTtoken HappyHorse 图生视频

要解决什么问题

在 OpenClaw 等对话环境里，图生视频（I2V） 往往不能靠普通聊天模型连通性测试完成：happyhorse-1.0-i2v 走 OpenAI 兼容的 chat/completions 且带图片输入，在 Models 页可能出现 bad_response_body，这并不代表密钥无效。

本技能面向 「已有静帧，需要生成短镜头」 的场景：用户附上图片、图片 URL，或近期上传的附件。生成走你配置的 GTtoken/OpenAI 兼容中继，默认 Base URL 为 https://api.modagent-homing.com/v1，模型 ID 为 happyhorse-1.0-i2v。

技能如何工作

触发条件很明确：请求里必须包含图像（URL、路径或附件上下文）。代理应从中取出图源，再调用 scripts/generate_happyhorse_i2v.py，传入 --prompt，以及 --image-url 或 --image-file。

• 环境变量：使用前设置 GTTOKEN_API_KEY；未设置时可回退 HAPPYHORSE_API_KEY。
• 可选覆盖：HAPPYHORSE_BASE_URL、HAPPYHORSE_MODEL 可改中继地址与模型名。
• 返回结果：优先返回中继给出的视频 URL 或本地下载路径；若只返回任务 ID、没有最终 URL，应展示原始 JSON，并说明需按 GTtoken 文档做轮询/结果查询。

Prompt 建议写清：画面里什么在动、镜头运动、时长（常见 3–15 秒）、画幅（如 16:9、9:16、1:1）、是否需要声音。单镜头、单一视觉节拍通常更稳，例如强调缓慢推进与背景轻微运动。

适用边界与注意点

• 本技能 仅用于视频生成；OpenClaw 默认聊天模型仍应使用常规模型（如 deepseek-v4-flash），不要把 happyhorse-1.0-i2v 设为默认对话模型。
• 401：密钥错误、过期或未授权 HappyHorse。
• model not found：模型 ID 或密钥权限不符，应使用 GTtoken 模型页上的 happyhorse-1.0-i2v。
• HTML 响应：多半是 Base URL 填错，应指向 https://api.modagent-homing.com/v1，而非控制台或官网首页。
• 图片字段不兼容：可重试 --payload-mode simple 或 --payload-mode image_url_field。