360 Secure SkillHub
360 安全技能中心

Veo 3 1

该 Skill 说明如何通过 PoYo AI 的视频生成接口提交 Veo 3.1（fast/quality）任务：选择模型、构建含提示词、参考图、时长、宽高比与分辨率的 JSON 请求体，使用 Bearer 鉴权提交后记录 task_id 并轮询状态或等待回调，另附 API 参考文档与提交脚本。

coolhackboy
coolhackboy
热度 60.90
最近更新 2026-07-08 08:58:43
分类：创作依赖：第三方 API / 代码执行 / 读写文件应用场景：视频编辑 / API 集成

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add veo-3-1
Metadata
name
poyo-veo-3-1
description
Use PoYo AI Veo 3.1 for frame-conditioned video generation through the `https://api.poyo.ai/api/generate/submit` endpoint. Use when a user wants fast or quality modes, start-frame and end-frame guidance, up to 4K resolution, reference-image video generation, or PoYo payloads for `veo3.1-fast` and `veo3.1-quality`.
metadata
{"openclaw":{"homepage":"https://poyo.ai/models/veo-3-1","requires":{"bins":["curl"],"env":["POYO_API_KEY"]},"primaryEnv":"POYO_API_KEY"}}

PoYo Veo 3.1 Video Generation

PoYo Links

Use this skill to submit and track PoYo jobs for the VEO 3.1 family.

Quick workflow

  1. Choose the right model id for the requested output.
  2. Build the request body for POST https://api.poyo.ai/api/generate/submit.
  3. Send Bearer-authenticated JSON with Authorization: Bearer <POYO_API_KEY>.
  4. Save the returned task_id.
  5. Poll unified task status or wait for callback_url notifications.

Request rules

  • Require top-level model.
  • Keep prompts concrete and outcome-focused.
  • Require input.prompt unless the user already supplied a full payload.
  • Use input.image_urls only when the task needs reference or source images.
  • Use input.duration when the clip length matters.
  • Use input.aspect_ratio when the output surface matters.
  • Use input.resolution when quality/cost tradeoffs matter.

Model selection

veo3.1-fast

Use for general generation with this model variant.

veo3.1-quality

Use for general generation with this model variant.

Execution

  • Read references/api.md for endpoint details, model ids, key fields, example payloads, and polling notes.
  • Use scripts/submit_veo_3_1.sh to submit a raw JSON payload from the shell.
  • If the user only needs a curl example, adapt the example from references/api.md instead of rewriting from scratch.
  • After submission, report the task_id clearly so follow-up polling is easy.

Output expectations

When helping with this model family, include:

  • chosen model id
  • final payload or a concise parameter summary
  • whether reference images are involved
  • returned task_id if a request was actually submitted
  • next step: poll status or wait for webhook