--- name: poyo-grok-imagine description: 使用 PoYo AI Grok Imagine Video，通过 https://api.poyo.ai/api/generate/submit 接口实现短文本到视频（text-to-video）及图像到视频（image-to-video）生成，并支持基于运动风格（motion-style）的控制。适用于用户需要生成 6 秒或 10 秒视频片段、可选 mode 样式配置，或需构造 PoYo 格式 grok-imagine 请求体的场景。 metadata: {"openclaw": {"homepage":"https://poyo.ai/models/grok-imagine", "requires": {"bins": ["curl"], "env": ["POYO_API_KEY"]}, "primaryEnv": "POYO_API_KEY"}}

PoYo Grok Imagine 视频生成

PoYo 相关链接

• 模型页面：https://poyo.ai/models/grok-imagine
• API 文档：https://docs.poyo.ai/api-manual/video-series/grok-imagine
• API 密钥管理页：https://poyo.ai/dashboard/api-key

使用本技能提交并跟踪 Grok Imagine Video 系列任务。

快速工作流

1. 根据请求输出选择合适的 model ID。
2. 构建向 POST https://api.poyo.ai/api/generate/submit 发送的请求体。
3. 以 Bearer 认证方式发送 JSON 请求，Header 中包含 Authorization: Bearer 。
4. 保存响应中返回的 task_id。
5. 轮询统一任务状态接口，或等待 callback_url 的 Webhook 通知。

请求规则

• 必须在顶层指定 model 字段。
• 提示词（prompt）应具体明确，聚焦最终输出效果。
• 除非用户已提供完整请求体（payload），否则必须提供 input.prompt。
• 仅当任务需参考图或源图像时，才使用 input.image_urls。
• 若对视频时长有要求，请设置 input.duration。
• 若对输出画面比例有要求，请设置 input.aspect_ratio。

模型选择

grok-imagine

适用于通用生成任务的该模型变体。

执行说明

• 查阅 references/api.md 获取接口详情、可用 model ID、关键字段定义、示例 payload 及轮询注意事项。
• 使用 scripts/submit_grok_imagine.sh 脚本，从命令行直接提交原始 JSON payload。
• 若用户仅需一个 curl 示例，建议直接复用 references/api.md 中的示例，无需重新编写。
• 提交成功后，请清晰返回 task_id，便于后续状态轮询操作。

输出预期

在协助使用该模型系列时，请包含以下信息：

• 所选的 model ID
• 最终请求体（payload）或简明参数摘要
• 是否涉及参考图像（reference images）
• 若实际提交了请求，则返回对应的 task_id
• 下一步操作：轮询任务状态，或等待 Webhook 回调

备注：

需从 https://poyo.ai 获取有效的 POYO_API_KEY。