Z Image

核心功能：调用PoYo AI Z-Image API提交文本转图任务，支持比例控制，可指定模型并跟踪任务状态。典型场景：用户需直接生成图片、调整图片比例的需求。输入为文本提示、可选比例参数或完整请求payload；输出包含选中的模型ID、参数摘要、任务ID，告知后续轮询状态或等待webhook的步骤。使用需POYO_API_KEY和curl工具。

coolhackboy

热度 59.99

最近更新 2026-07-08 08:58:56

分类：创作依赖：第三方 API / 代码执行应用场景：图像生成

安装技能

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

执行命令安装此 skill： npx secure-skills-cli add z-image

Metadata

name: poyo-z-image
description: Use PoYo AI Z-Image for straightforward prompt-based image generation through the `https://api.poyo.ai/api/generate/submit` endpoint. Use when a user wants direct text-to-image output, simple aspect-ratio control, lightweight PoYo payloads, or submissions for `z-image`.
metadata: {"openclaw":{"homepage":"https://poyo.ai/models/z-image","requires":{"bins":["curl"],"env":["POYO_API_KEY"]},"primaryEnv":"POYO_API_KEY"}}

PoYo Z-Image Generation

PoYo Links

Model page: https://poyo.ai/models/z-image
API docs: https://docs.poyo.ai/api-manual/image-series/z-image
API key page: https://poyo.ai/dashboard/api-key

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_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.size to match the intended aspect ratio or canvas.

Model selection

`z-image`

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