freepik_skill

Overview

This skill integrates with Freepik's AI API to generate images, videos, icons, audio, and to search stock content. It exposes multiple models (Mystic, Flux, Kling, Seedream, RunWay and others) and supports upscaling, editing, LoRA, and asynchronous task polling. Use it when you need high-quality generative assets or to find Freepik stock content programmatically.

How this skill works

The skill sends authenticated requests to Freepik's endpoints and follows an async task pattern: submit a job, poll status, and extract the temporary CDN result URL when completed. It maps commands like generate, video, edit, icon, audio, and stock to specific model endpoints and parameter sets. It enforces security rules: only call api.freepik.com, prefer URL inputs over local base64, and never transmit files outside user-provided inputs.

When to use it

• Create photorealistic or stylized images from text prompts
• Generate short AI-driven videos from text or reference images
• Edit images or remove backgrounds with instruction-driven endpoints
• Produce icons, generate or edit audio, and upscale images
• Search or download Freepik stock assets programmatically

Best practices

• Set FREEPIK_API_KEY as environment variable and validate 401/403 guidance before running
• Choose the model that matches the task: Mystic for high-res photos, Flux/Klein for fast outputs, Kling for multi-shot video
• Use URL-based references when APIs accept them instead of embedding base64 files
• Follow the async pattern: submit task -> poll status -> extract signed CDN URL and present it to users
• Respect safety_tolerance and guidance parameters for sensitive content and reproducibility (use seed when needed)

Example use cases

• Generate a 2K product hero image with mystic including a style_reference URL
• Create a 10s marketing clip using kling-v3-omni-pro with multi_prompt shots and generated audio
• Edit a user photo with seedream-v4-5-edit using up to 5 reference images and instruction text
• Upscale a design with Magnific upscaling and return the temporary signed URL to the user
• Search Freepik stock for vector icons and download selected results into a session folder