pixshop-creative-api_skill

Overview

This skill exposes the Pixshop Creative REST API for integrating AI image generation, editing, video, prompts, apps and community endpoints into your app. It provides unified JSON responses and a broad set of endpoints including 15+ image models, 16 editing tools, video generation, a prompt library and an apps marketplace. Use it to call endpoints via HTTP (curl/fetch) or to drive server-side automation.

How this skill works

Authenticate with a Bearer token (CLI login or Supabase Auth) and call endpoints under /api. Endpoints return { success, data?, error? } and cover groups: AI generation, editing tools, Nano Banana apps, prompt library, meme generation and agent skills. Long-running tasks such as video generation return a task ID to poll for results.

When to use it

• Add on-demand image or video generation to web or mobile apps
• Automate bulk content creation with prompt-library driven batches
• Embed advanced editing tools (inpaint, face-swap, upscale, try-on) in workflows
• Expose a curated apps marketplace or prompt suggestions in a UI
• Run server-side agent skills to orchestrate multi-step creative tasks

Best practices

• Always retrieve and refresh a Bearer token; write endpoints that handle 401 and refresh logic
• Use prompt-library to standardize prompts and reduce trial-and-error for quality
• Batch generate where possible and respect rate limits; implement exponential backoff for 429 responses
• Send images as either base64 data URLs or hosted HTTP URLs depending on client constraints
• Treat video generation and other async jobs as task IDs and implement polling or webhooks if supported

Example use cases

• A social app that generates stylized profile images via POST /api/ai/generate and upscales results with /api/tools/upscale
• An e-commerce pipeline that applies virtual try-on and fashion photoshoot tools to product model photos
• A marketing automation system that pulls prompts from /api/prompt-library and batch-generates campaign visuals
• A creative editor that exposes make-up analysis, inpainting and sticker generation as in-app tools
• A bot that discovers agent skills via /api/agent/discover and executes multi-step image workflows