Seedream 5.0 Pro API Examples for PoYo

Backend-safe examples for building precise image generation and editing workflows with Seedream 5.0 Pro on PoYo.

Use Pro when the result must carry structured information: product layouts, multilingual posters, infographics, packaging concepts, or targeted edits that should preserve the rest of the scene. Use Seedream 5.0 Lite when lower-cost, higher-volume drafting matters more.

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

What This Repo Covers

• Text-to-image generation with seedream-5.0-pro
• Reference-guided editing with seedream-5.0-pro-edit
• Eight aspect-ratio presets with separate 1K or 2K resolution control
• JPEG or PNG output and safety-checker configuration
• Async task handling with polling and production webhooks
• cURL and dependency-free 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. Never expose it in browser code, mobile apps, screenshots, public repositories, or client-side logs.

Production Pattern

1. Keep POYO_API_KEY on the server.
2. Submit a generation or edit task.
3. Store data.task_id immediately.
4. Poll status while testing.
5. Use callback_url webhooks in production.
6. Read the final file only after the task reaches finished.

Models

Model	Use it for
seedream-5.0-pro	Structured text-to-image work, dense layouts, product visuals, and multilingual design assets
seedream-5.0-pro-edit	Targeted changes with up to 10 reference images while preserving scene structure

Examples

Path	What it covers
curl/generate.md	Copy-paste generation and edit requests.
node/	Native Node.js submit and polling example.
docs/prompt-examples.md	Prompts that test layout, typography, product rendering, and local edits.
docs/production-notes.md	Security, reliability, validation, and cost guidance.
webhooks/express-webhook/	Minimal Express receiver for PoYo callbacks.

Run Checks

make check

On Windows:

./scripts/check.ps1

License

MIT