--- name: poyo-gpt-4o-image description: 通过 https://api.poyo.ai/api/generate/submit 接口调用 PoYo AI GPT-4o Image。当用户希望使用该模型族生成或编辑媒体内容、构建 PoYo 兼容的请求载荷、提交任务，或轮询 gpt-4o-image、gpt-4o-image-edit 任务状态时使用。 metadata: {"openclaw": {"homepage":"https://poyo.ai/models/gpt-4o-image-api", "requires": {"bins": ["curl"], "env": ["POYO_API_KEY"]}, "primaryEnv": "POYO_API_KEY"}}

PoYo GPT 4O Image

PoYo 相关链接

• 模型页面：https://poyo.ai/models/gpt-4o-image-api
• API 文档：https://docs.poyo.ai/api-manual/image-series/gpt-4o-image
• API 密钥页面：https://poyo.ai/dashboard/api-key

使用本技能提交并跟踪 GPT-4o Image 系列的 PoYo 任务。

快速工作流

1. 根据所需输出选择合适的 model id。
2. 构造 POST https://api.poyo.ai/api/generate/submit 请求体。
3. 以 Bearer 认证方式发送 JSON 请求，Header 中包含 Authorization: Bearer 。
4. 保存响应中返回的 task_id。
5. 轮询统一任务状态接口，或等待 callback_url 发送的 Webhook 通知。

请求规则

• 必须在顶层指定 model 字段。
• 提示词（prompt）应具体明确，聚焦于预期输出结果。
• 除非用户已提供完整请求载荷，否则必须提供 input.prompt。
• 仅当任务需要参考图像或源图像时，才使用 input.image_urls。
• 使用 input.size 指定目标宽高比或画布尺寸。

模型选择

gpt-4o-image

适用于该模型变体的通用图像生成任务。

gpt-4o-image-edit

适用于对已提供图像进行编辑或修改的任务。

执行说明

• 查阅 references/api.md 获取端点详情、可用 model id、关键字段定义、示例载荷及轮询注意事项。
• 使用 scripts/submit_gpt_4o_image.sh 脚本，从 Shell 提交原始 JSON 载荷。
• 若用户仅需 curl 示例命令，请直接基于 references/api.md 中的示例进行适配，无需重新编写。
• 提交完成后，请清晰反馈返回的 task_id，以便后续轮询操作顺利开展。

输出预期

在协助处理该模型族相关任务时，请包含以下信息：

• 选定的 model id
• 最终请求载荷，或简洁的参数摘要
• 是否涉及参考图像
• 若已实际提交请求，则需提供返回的 task_id
• 下一步操作：轮询任务状态，或等待 Webhook 回调

备注：

需从 https://poyo.ai 获取 POYO_API_KEY。