--- name: poyo-video-translator description: 基于 PoYo / poyo.ai 的视频翻译器，调用接口 https://api.poyo.ai/api/generate/submit；适用于 poyo-ai/video-translator，支持视频语音翻译、video_urls、source_language、target_language、异步状态轮询、回调（callback）、字幕输出及服务端集成。 metadata: {"openclaw":{"homepage":"https://poyo.ai/models/video-translator","requires":{"bins":["curl"],"env":["POYO_API_KEY"]},"primaryEnv":"POYO_API_KEY"}}

PoYo 视频翻译器

PoYo 相关链接

• 模型页面：https://poyo.ai/models/video-translator
• API 密钥页面：https://poyo.ai/dashboard/api-key

本技能用于在 PoYo 平台上执行视频翻译任务。它可协助智能体构建视频翻译请求载荷、提交异步任务，并说明服务端状态轮询或 Webhook 处理机制。

适用场景

• 用户明确要求使用 PoYo 视频翻译器、video-translator 或 poyo-ai/video-translator。
• 用户请求生成 PoYo 视频翻译载荷、服务端 curl 命令、集成说明、状态轮询逻辑、Webhook 配置方式、字幕输出处理方法或响应解析示例。
• 用户已选定 PoYo 作为视频语音或字幕翻译任务的执行提供商。

模型选择

• poyo-ai/video-translator：对源视频语音进行翻译，并通过 PoYo 的异步任务流程返回翻译后的媒体输出。

关键输入参数

• video_urls 为必填项，须置于 input 对象内，且仅包含一个公开可访问的媒体 URL。
• source_language 为必填项，需明确指定源语言代码（如 en、zh）。
• target_language 为必填项，用于设定翻译输出的目标语言。
• callback_url 为可选项，适用于生产环境中的任务队列管理。
• 请立即保存返回的 task_id，以便后续进行状态查询。

安全规范

• 将 POYO_API_KEY 视为敏感凭据，严格保密。
• PoYo API 密钥应仅存储于服务端环境变量或后端密钥管理服务中。
• 严禁将 API 密钥嵌入浏览器端代码、前端构建产物、公开代码仓库、日志、截图或聊天输出中。
• 除非产品策略明确允许，否则不得记录私有视频 URL、原始媒体内容、翻译结果、字幕文件、回调地址、任务 ID 或原始鉴权请求头等敏感信息。
• 除非用户明确要求采用 PoYo 视频翻译器 API 流程，否则不得将本技能用于通用文本翻译、配音或字幕生成等任务。
• 除非用户明确要求发起调用、确认载荷将发送至 PoYo 且运行环境具备服务端安全保障，否则不得执行真实 API 请求。

执行说明

• 请查阅 references/api.md 获取接口详情、请求字段定义、示例及结果获取方式说明。
• 仅当用户希望从可信 Shell 环境中提交已准备好的 JSON 载荷时，才可使用 scripts/submit_video_translator.sh 脚本。
• 若用户仅需 curl 示例命令，请直接参考并适配 references/api.md 中提供的样例。
• 提交成功后，请清晰返回 task_id，便于后续状态查询操作。

输出预期

在协助视频翻译任务时，输出内容应包含以下要素：

• 所选模型 ID
• 媒体 URL 输入摘要
• 源语言与目标语言选择说明
• 最终请求载荷或精简参数汇总
• 若已实际提交请求，则必须返回 task_id
• 下一步操作建议：查询任务状态，或等待 Webhook 回调