360 Secure SkillHub
360 安全技能中心

Poyo Flux 2 Api

该技能对接PoYo AI Flux 2系列模型，支持调用flux-2-pro、flux-2-flex及对应编辑模型，构建合规请求体并提交生成/编辑任务，可跟踪任务状态。典型场景包括生成高质量图片、编辑已有图片等。需POYO_API_KEY和curl工具，输入为用户需求、参考图等，输出含选定模型ID、参数摘要、任务ID及后续操作指引。

coolhackboy
coolhackboy
热度 60.77
最近更新 2026-07-09 10:50:30
分类：创作依赖：第三方 API / 代码执行应用场景：图像生成

安装技能

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

执行命令安装此 skill： npx secure-skills-cli add poyo-flux-2-api
Metadata
name
poyo-flux-2
description
Use PoYo AI Flux 2 through the `https://api.poyo.ai/api/generate/submit` endpoint. Use when a user wants to generate or edit media with this model family, prepare PoYo-compatible payloads, submit jobs, or poll task status for `flux-2-pro`, `flux-2-pro-edit`, `flux-2-flex`, `flux-2-flex-edit`.
metadata
{"openclaw":{"homepage":"https://poyo.ai/models/flux-2","requires":{"bins":["curl"],"env":["POYO_API_KEY"]},"primaryEnv":"POYO_API_KEY"}}

PoYo Flux 2

PoYo Links

Use this skill to submit and track PoYo jobs for the Flux 2 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.size to match the intended aspect ratio or canvas.
  • Use input.resolution when quality/cost tradeoffs matter.

Model selection

flux-2-pro

Use for higher-quality or premium jobs.

flux-2-pro-edit

Use for editing or modifying supplied images.

flux-2-flex

Use for general generation with this model variant.

flux-2-flex-edit

Use for editing or modifying supplied images.

Execution

  • Read references/api.md for endpoint details, model ids, key fields, example payloads, and polling notes.
  • Use scripts/submit_flux_2.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

Notes:

Needs POYO_API_KEY from https://poyo.ai