ClawKit Logo
ClawKitReliability Toolkit
Back to Registry
Official Verified ai models Safety 4/5

poyo-flux-2

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

Why use this skill?

Integrate PoYo Flux 2 AI into your OpenClaw workflow. Easily generate, edit, and track high-quality media tasks with this powerful API automation skill.

skill-install — Terminal

Install via CLI (Recommended)

clawhub install openclaw/skills/skills/coolhackboy/poyo-flux-2-api
Or

What This Skill Does

The poyo-flux-2 skill is an integration tool for the OpenClaw AI agent that enables seamless interaction with the PoYo AI Flux 2 model family. This skill serves as a gateway to the https://api.poyo.ai/api/generate/submit endpoint, allowing users to leverage high-performance generative models like flux-2-pro and flux-2-flex directly through their command-line or AI-agent interface. It automates the process of payload construction, authentication handling, and job submission, while providing structured feedback for polling task statuses. Whether you are generating high-fidelity images from text prompts or utilizing the edit variants to modify existing visual assets, this skill manages the API handshake and response parsing, ensuring your workflow remains efficient and error-free.

Installation

To integrate this functionality into your environment, run the following command in your terminal: clawhub install openclaw/skills/skills/coolhackboy/poyo-flux-2-api After installation, ensure you have your POYO_API_KEY configured in your environment variables to allow the skill to authenticate requests successfully. You can obtain your key from the official PoYo.ai dashboard.

Use Cases

  • Pro-Level Generation: Use the flux-2-pro model to create high-quality, premium visual assets for marketing or professional design projects.
  • Image Editing: Utilize flux-2-pro-edit or flux-2-flex-edit to perform sophisticated image manipulations, such as object swapping, style transferring, or image-to-image refinement.
  • Batch Workflow Automation: Integrate the scripts/submit_flux_2.sh helper to run multiple generation tasks programmatically, perfect for bulk asset production pipelines.
  • Rapid Prototyping: Use flux-2-flex for cost-effective, high-speed iteration on visual concepts before committing to a final, high-resolution render.

Example Prompts

  1. "Generate a high-quality photorealistic portrait of an astronaut sitting in a cafe using flux-2-pro with a 16:9 aspect ratio."
  2. "Use flux-2-pro-edit to change the color of the car in this image to matte black. Here is the URL: [image_url]."
  3. "Run a batch job using flux-2-flex for a series of fantasy landscape sketches, and save the task IDs for tracking."

Tips & Limitations

  • Model Selection: Always match your requirements to the correct model. Use 'pro' variants for quality-critical tasks and 'flex' variants for cost-sensitive or standard tasks.
  • Prompt Engineering: Keep prompts descriptive but focused. The Flux 2 family performs best when given clear subjects, environments, and stylistic descriptors.
  • API Constraints: Always monitor the task_id returned by the API. If your job is long-running, use the polling mechanism or configure a webhook via the callback_url to receive automatic notifications upon completion.
  • Input Sanitization: When using edit features, ensure image URLs are public and accessible to the PoYo API to avoid submission errors.
Read Full Documentation on GitHub

Metadata

Author@coolhackboy
Stars3409
Views1
Updated2026-03-25
View Author Profile
AI Skill Finder

Not sure this is the right skill?

Describe what you want to build — we'll match you to the best skill from 16,000+ options.

Find the right skill
Add to Configuration

Paste this into your clawhub.json to enable this plugin.

{
  "plugins": {
    "official-coolhackboy-poyo-flux-2-api": {
      "enabled": true,
      "auto_update": true
    }
  }
}

Tags(AI)

#image-generation#ai-models#api-integration#flux-2#media-editing
Safety Score: 4/5

Flags: external-api

Related Skills

poyo-hailuo-02

Use PoYo AI Hailuo 02 for prompt-optimized video generation and image-to-video workflows through the `https://api.poyo.ai/api/generate/submit` endpoint. Use when a user wants standard or pro video jobs, optional prompt optimization, end-frame control, or PoYo payloads for `hailuo-02` and `hailuo-02-pro`.

coolhackboy 3409

poyo-kling-3-0

Kling 3.0 video generation on PoYo / poyo.ai via `https://api.poyo.ai/api/generate/submit`; use for `kling-3.0/standard`, `kling-3.0/pro`, single-shot, multi-shot, `multi_prompt`, `kling_elements`, and sound-enabled output.

coolhackboy 3409

poyo-wan-2-6

Wan 2.6 video generation on PoYo / poyo.ai via `https://api.poyo.ai/api/generate/submit`; use for `wan2.6-text-to-video`, `wan2.6-image-to-video`, `wan2.6-video-to-video`, text-to-video, image-to-video, video-to-video, and `multi_shots` control.

coolhackboy 3409

poyo-nano-banana

Use PoYo AI Nano Banana for general image generation and image editing across many aspect ratios through the `https://api.poyo.ai/api/generate/submit` endpoint. Use when a user wants prompt-based images, reference-image edits, wide or tall canvases, or PoYo payloads for `nano-banana` and `nano-banana-edit`.

coolhackboy 3409

poyo-seedream-4-5

Seedream 4.5 image generation and editing on PoYo / poyo.ai via `https://api.poyo.ai/api/generate/submit`; use for `seedream-4.5`, `seedream-4.5-edit`, 2K/4K output, multi-reference editing, and higher image counts.

coolhackboy 3409