PoYo Sora 2

PoYo 链接

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

使用此技能在 PoYo AI 上提交并跟踪 Sora 2 视频任务。

快速工作流

1. 选择模型：
   • sora-2：用于标准 Sora 2 生成
   • sora-2-private：用于私有标准质量变体
2. 构建请求体（request body）。
3. 向 https://api.poyo.ai/api/generate/submit 发送带 Bearer 认证的 POST 请求。
4. 保存返回的 task_id。
5. 轮询统一任务状态，直至任务完成；若用户已配置 Webhook，则可依赖 callback_url 接收回调通知。

请求规则

• 必须提供 Authorization: Bearer 请求头。
• 请求体顶层必须包含 model 字段。
• 必须提供 input.prompt。
• 仅在图像转视频（image-to-video）场景下使用 input.image_urls；PoYo 文档指出仅支持单张图像。
• 当用户指定视频片段时长（clip length）时，使用 input.duration；有效值为 10 或 15（单位：秒）。
• 按需使用 input.aspect_ratio；有效值为 16:9 或 9:16。
• 可选的风格化控制可通过 input.style 和 input.storyboard 实现。

模型选择

sora-2

适用于：

• 标准文本生成视频（text-to-video）
• 标准图像生成视频（image-to-video）
• PoYo 平台上的默认 Sora 2 任务

sora-2-private

适用于：

• 用户明确要求使用私有标准质量变体的场景
• 用户账号或工作流中预设了该私有模型 ID 的情况

执行说明

• 参阅 references/api.md 获取载荷字段定义、示例及轮询注意事项。
• 当适合直接调用 API 时，可使用 scripts/submit_sora_2.sh 脚本从 Shell 提交任务。
• 如用户需要原始 curl 示例，请基于 references/api.md 中的样例进行适配。
• 提交后，请清晰反馈返回的 task_id，以便后续轮询操作顺利进行。

输出预期

协助处理 Sora 2 任务时，请包含以下信息：

• 所选模型
• 请求类型是文本生成视频还是图像生成视频
• 最终请求载荷（payload），或参数摘要
• 若请求已实际提交，则需提供返回的 task_id
• 下一步操作：轮询任务状态，或等待 Webhook 回调