APIDot Happy Horse 1.1 API

将 APIDot 用作面向 Happy Horse 1.1 的 API 接口，支持音画同步短视频、文本生成视频（text-to-video）、图像生成视频（image-to-video）、参考图生成视频（reference-to-video）、轮询（polling）及 Webhook 工作流。

本技能将用户关于 Happy Horse 1.1 的问题路由至当前 APIDot 模型页面、文档、参考说明以及通用异步集成模式。该技能仅提供文档支持：不包含任何脚本、不发起网络请求、也不存储凭据。

本次发布包含 SKILL.md 文件，以及位于 references/api.md 中的非可执行说明文档。不包含可执行文件、安装时自动化脚本、Shell 自动化脚本、捆绑式 API 客户端、自动网络调用或已存储的凭据。

从 APIDot 入门

若你来自 ClawHub，请使用以下 APIDot 入口地址：

• 打开 Happy Horse 1.1 模型页面：https://apidot.ai/models/happy-horse-1-1
• 阅读 Happy Horse 1.1 API 文档：https://apidot.ai/docs/happy-horse-1-1
• 打开账户控制台：https://apidot.ai/dashboard/api-key
• 参考通用 APIDot 示例：https://github.com/APIDotAI/apidot-examples

适用场景

当用户提出以下需求时，请使用本技能：

• 构建基于 APIDot 的 Happy Horse 1.1 API 集成。
• 根据提示词、单张源图像或参考图像生成短视频。
• 规划音画同步视频、720p 或 1080p 输出分辨率、视频时长、轮询机制或 Webhook 交付方式。
• 通过 APIDot 使用 Alibaba Happy Horse 1.1、文本生成视频、图像生成视频或参考图生成视频能力。
• 实现基于 APIDot 的异步 Happy Horse 1.1 任务，包括任务提交、任务状态轮询或回调（callback）处理。
• 查找当前 APIDot 关于 Happy Horse 1.1 的文档、模型页面或通用示例。

安全规范

• 将 APIDOT_API_KEY 视为机密信息。
• 将 APIDot API 密钥保存在服务端环境变量或后端密钥管理器中。
• 切勿将 API 密钥置于浏览器端代码、前端构建包、公开仓库、日志、截图或聊天输出中。
• 除非用户明确要求且提供了安全的服务端运行环境，否则不得发起实际 API 调用。
• 不得虚构请求字段、商业条款、模型可用性、可靠性声明或竞品对比内容。
• 所有受支持的输入参数、配额限制及当前产品详情，请以最新 APIDot 文档与模型页面为准。

Happy Horse 1.1 工作流

APIDot 上 Happy Horse 1.1 的生成流程遵循通用异步任务模式：

1. 从当前 APIDot 文档中选择文本生成视频、图像生成视频或参考图生成视频任一模式。
2. 通过文档中所述的 APIDot 异步生成流程提交生成请求。
3. 立即保存返回的 data.task_id。
4. 在本地测试中，使用文档中指定的任务状态查询 API 轮询任务状态。
5. 对于可能超出当前页面生命周期的生产级任务，请使用 callback_url Webhook 方式交付结果。
6. 仅当任务进入最终成功状态（terminal success state）后，才持久化保存最终视频 URL。

请勿猜测模型特定的请求载荷字段。若用户需要可复制的请求示例，请引导其查阅最新 APIDot 文档或通用 APIDot 示例。

模型路由

如需进行本地化、非可执行的请求设计与异步工作流记录，请参阅 references/api.md。

集成建议

• 如需跨模型家族获取通用视频生成指导，请使用 apidot-video-generation-api 技能。
• 仅当请求明确指定通过 APIDot 使用 Happy Horse 1.1 时，才启用本技能。
• 在规划输入前，请确认用户所需的是纯文本提示（prompt-only）、单图输入（one-image）还是参考图输入（reference-image）方案。
• 请将 task_id、所选模型、用户 ID、源媒体引用、请求状态及最终视频 URL 一并持久化存储。
• 在提交依赖图像的工作流前，请预先校验源媒体 URL 的有效性。
• 将 Webhook 处理器设计为幂等（idempotent），确保重复投递不会产生重复的可见结果。
• 对临时性网络失败应采用退避策略重试；但不可对无效载荷（invalid payloads）不做修改地重复提交。
• 避免记录 API 密钥、私有提示词、私有媒体 URL、回调 URL 或生成的视频 URL。

官方链接

• 官网：https://apidot.ai
• Happy Horse 1.1 模型页面：https://apidot.ai/models/happy-horse-1-1
• Happy Horse 1.1 文档：https://apidot.ai/docs/happy-horse-1-1
• APIDot 文档：https://apidot.ai/docs
• 快速入门指南：https://apidot.ai/docs/quickstart
• Webhook 文档：https://apidot.ai/docs/webhooks
• 账户控制台：https://apidot.ai/dashboard/api-key
• 主示例仓库：https://github.com/APIDotAI/apidot-examples
• GitHub 组织主页：https://github.com/APIDotAI
• 技术支持邮箱：support@apidot.ai