Poyo Sora 2 Pro

Use PoYo AI Sora 2 Pro for longer premium video generation through the https://api.poyo.ai/api/generate/submit endpoint. Use when a user wants 15s or 25s cinematic clips, optional storyboard control, style presets, image-to-video input, or PoYo payloads for sora-2-pro and sora-2-pro-private.

coolhackboy@coolhackboy

Install

openclaw skills install @coolhackboy/poyo-sora-2-pro

PoYo Sora 2 Pro Video Generation

PoYo Links

Model page: https://poyo.ai/models/sora-2-pro
API docs: https://docs.poyo.ai/api-manual/video-series/sora-2-pro
API key page: https://poyo.ai/dashboard/api-key

Use this skill to submit and track PoYo jobs for the Sora 2 Pro family.

Quick workflow

Choose the right model id for the requested output.
Build the request body for POST https://api.poyo.ai/api/generate/submit.
Send Bearer-authenticated JSON with Authorization: Bearer <POYO_API_KEY>.
Save the returned task_id.
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.

Model selection

`sora-2-pro`

Use for higher-quality or premium jobs.

`sora-2-pro-private`

Use for private deployment or account-specific private variants.

Execution

Read references/api.md for endpoint details, model ids, key fields, example payloads, and polling notes.
Use scripts/submit_sora_2_pro.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