- 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/submitendpoint. Use when a user wants 6s or 10s clips, optionalmodestyling, or PoYo payloads forgrok-imagine. - metadata
- {"openclaw": {"homepage": "https://docs.poyo.ai/api-manual/video-series/grok-imagine", "requires": {"bins": ["curl"], "env": ["POYO_API_KEY"]}, "primaryEnv": "POYO_API_KEY"}}
PoYo Grok Imagine Video Generation
Use this skill to submit and track PoYo jobs for the Grok Imagine Video 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_urlnotifications.
Request rules
- Require top-level
model. - Keep prompts concrete and outcome-focused.
- Require
input.promptunless the user already supplied a full payload. - Use
input.image_urlsonly when the task needs reference or source images. - Use
input.durationwhen the clip length matters. - Use
input.aspect_ratiowhen the output surface matters.
Model selection
grok-imagine
Use for general generation with this model variant.
Execution
- Read
references/api.mdfor endpoint details, model ids, key fields, example payloads, and polling notes. - Use
scripts/submit_grok_imagine.shto submit a raw JSON payload from the shell. - If the user only needs a curl example, adapt the example from
references/api.mdinstead of rewriting from scratch. - After submission, report the
task_idclearly 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_idif a request was actually submitted - next step: poll status or wait for webhook
Notes:
Needs POYO_API_KEY from https://poyo.ai PoYo.ai - Premium AI API Platform | Image, Video, Music & Chat APIs - 80% Cheaper