FLUX.2 API Examples for PoYo

Focused server-side examples for building FLUX.2 image generation and editing workflows on PoYo.

FLUX.2 is useful for high-quality image generation, precise creative control, image editing, and production visual drafts that need pro or flex variants.

Try on PoYo | Get API Key | Docs | Pricing | Main Examples

What This Repo Covers

• Text-to-image with flux-2-pro
• Edit paths with FLUX.2 edit variants
• Size and resolution controls
• Async task flow with polling and webhooks
• cURL and Node.js backend examples

Quick Start

cp .env.example .env
export POYO_API_KEY="your-api-key"

Run the Node.js example:

cd node
npm start

Keep POYO_API_KEY on the server. Do not expose it in browser code, mobile apps, screenshots, or public logs.

Production Pattern

• Keep POYO_API_KEY on the server
• Submit a generation task
• Store data.task_id
• Poll status while testing
• Use callback_url webhooks in production

Models

This repo uses flux-2-pro, flux-2-pro-edit, flux-2-flex, flux-2-flex-edit.

Examples

Path	What it covers
curl/generate.md	Copy-paste async submit request.
node/	Native Node.js backend example with polling.
docs/prompt-examples.md	Practical prompts for product workflows and creative tests.
docs/production-notes.md	Security and reliability notes before launch.
webhooks/express-webhook/	Minimal Express receiver for PoYo callbacks.

Run Checks

make check

On Windows:

./scripts/check.ps1

License

MIT