核心用法
PoYo Grok Imagine Video 技能专用于调用 PoYo AI 平台的 Grok Imagine 视频生成模型，支持将文本或图片转换为 6 秒或 10 秒的短视频片段。用户通过 https://api.poyo.ai/api/generate/submit 端点提交任务，需配置 POYO_API_KEY 环境变量进行 Bearer Token 认证。
关键执行流程：选择正确的 model ID → 构建包含 input.prompt、input.duration（6s/10s）、input.aspect_ratio 等字段的 JSON 请求体 → 发送 POST 请求 → 保存返回的 task_id → 轮询任务状态或等待 callback_url webhook 通知。
显著优点
- 多模态输入：同时支持文本提示（
prompt）和图片参考（image_urls），满足文生视频和图生视频双重需求 - 精细化控制：通过
mode参数实现运动风格调控，可指定特定的视觉动态效果 - 异步任务架构：采用任务 ID + 轮询/回调的异步模式，适合长时视频生成场景
- 标准化接口：基于 PoYo 统一 API 规范，与其他 PoYo 模型共享认证和监控机制
潜在缺点与局限性
- 时长受限：仅支持 6 秒和 10 秒两种固定时长，无法满足长视频或复杂叙事需求
- 外部依赖性强：完全依赖 PoYo 平台可用性，若 PoYo 服务中断或 API 变更，技能将失效
- 无实时预览：必须等待完整生成后才能获取结果，无法边生成边查看
- 资源门槛：需要有效的 PoYo API Key 且可能产生计费，存在使用成本
适合人群
- 内容创作者：需要快速生成短视频素材用于社交媒体
- 产品设计师：制作动态原型或概念演示视频
- AI 应用开发者：集成视频生成功能到自有产品
- 营销团队：批量生产广告片段或视觉内容
常规风险
- API 密钥泄露：
POYO_API_KEY需妥善保管，避免硬编码或意外暴露 - 内容合规风险：生成内容需符合 PoYo 平台使用政策及当地法律法规
- 任务失败处理：网络超时或参数错误可能导致任务提交失败，需实现重试机制
- 成本失控：视频生成消耗 tokens 或积分，高频调用前需确认计费策略