| 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`. |
PoYo Flux 2
Use this skill to submit and track PoYo jobs for the Flux 2 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.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
PoYo.ai - Premium AI API Platform | Image, Video, Music & Chat APIs - 80% Cheaper
