- name
- poyo-z-image
- description
- Use PoYo AI Z-Image for straightforward prompt-based image generation through the
https://api.poyo.ai/api/generate/submitendpoint. Use when a user wants direct text-to-image output, simple aspect-ratio control, lightweight PoYo payloads, or submissions forz-image. - metadata
- {"openclaw": {"homepage": "https://docs.poyo.ai/api-manual/image-series/z-image", "requires": {"bins": ["curl"], "env": ["POYO_API_KEY"]}, "primaryEnv": "POYO_API_KEY"}}
PoYo Z-Image Generation
Use this skill to submit and track PoYo jobs for the Z-Image 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.sizeto match the intended aspect ratio or canvas.
Model selection
z-image
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_z_image.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