poyo-grok-imagine

name	poyo-grok-imagine
description	Use PoYo AI Grok Imagine Video for short text-to-video and image-to-video generation with motion-style controls through the `https://api.poyo.ai/api/generate/submit` endpoint. Use when a user wants 6s or 10s clips, optional `mode` styling, or PoYo payloads for `grok-imagine`.

PoYo Grok Imagine Video Generation

Use this skill to submit and track PoYo jobs for the Grok Imagine Video 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.

Model selection

grok-imagine

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_grok_imagine.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.