{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Bria AI Skills - Controllable Image Generation for Coding Agents","siteUrl":"https://docs.bria.ai","llmstxt":{"hide":false,"title":"Bria AI API","description":"bria.ai helps you build products and workflows by delivering controllable, easy-to-integrate and safe generative visual AI capabilities.","details":{"path":"_llmstxt-details.md"},"sections":[{"title":"Integrations","description":"MCP server, Claude Skill, and Python SDK.","includeFiles":["MCP-authentication.md","integration-methods/bria-skill.md","integration-methods/python-sdk.md"]},{"title":"Getting Started","description":"Authentication, API overview, and platform concepts.","includeFiles":["index.md","products-overview.md","safety.md","vgl.md","best-practices-overview.md"]},{"title":"Image Generation","description":"Generate images using text prompts or structured JSON via FIBO models.","includeFiles":["image-generation.md","image-generation.yaml"]},{"title":"Image Editing","description":"Edit, transform, and enhance images with 20+ specialized endpoints.","includeFiles":["image-editing.md","image-editing.yaml"]},{"title":"Video Editing","description":"Remove backgrounds (REST async or real-time streaming), erase objects, upscale, and generate masks for video.","includeFiles":["video-editing.md","local-video-upload-service.md","video-editing.yaml","streaming-rmbg.md"]},{"title":"Product Shot Editing","description":"SKU packshots, lifestyle scenes, and automotive product imagery.","includeFiles":["product-shot-editing.md","product-shot-editing.yaml"]},{"title":"Optional","description":"Ads, image onboarding, and attribution.","includeFiles":["campaign-generation.md","image-onboarding.md","bria-attribution-service.md","ad-generation.md","campaign-generation.yaml","image-onboarding.yaml","bria-attribution-service.yaml","ad-generation.yaml"]}],"excludeFiles":["_llmstxt-details.md","_partials.md","CHANGELOG.md"]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"bria-ai-skills---controllable-image-generation-for-coding-agents","__idx":0},"children":["Bria AI Skills - Controllable Image Generation for Coding Agents"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Generate, edit, and precisely control images directly from your AI coding agent using ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://bria.ai"},"children":["Bria.ai"]},"'s commercially-safe models. Unlike black-box generators, Bria gives you fine-grained control: edit specific objects, mask regions, control lighting/season/style independently, and chain operations in pipelines."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Works with:"]}," Claude Code, Cursor, Cline, Codex, and ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://skills.sh"},"children":["37+ other agents"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"quick-start","__idx":1},"children":["Quick Start"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"1-install","__idx":2},"children":["1. Install"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"npx skills add bria-ai/bria-skill\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"2-get-a-free-api-key","__idx":3},"children":["2. Get a free API key"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Sign up at ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://platform.bria.ai/console/account/api-keys?utm_source=skill&utm_campaign=bria_skills&utm_content=readme"},"children":["platform.bria.ai"]}," and create an API key."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"3-set-the-key","__idx":4},"children":["3. Set the key"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"export BRIA_API_KEY=\"your-key-here\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Or just start using the skill - it will walk you through setup automatically."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"4-use-it","__idx":5},"children":["4. Use it"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Ask your agent to generate images, remove backgrounds, edit photos, and more. The skill handles the rest."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"skills-included","__idx":6},"children":["Skills Included"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Skill"},"children":["Skill"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://github.com/Bria-AI/bria-skill/blob/main/skills/bria-ai/SKILL.md"},"children":["bria-ai"]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Controllable image generation & editing - 18+ capabilities including text-to-image, object-level editing, background removal, upscaling, restyling, relighting, and product photography"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://github.com/Bria-AI/bria-skill/blob/main/skills/vgl/SKILL.md"},"children":["vgl"]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Maximum generation control - structured JSON (Visual Generation Language) that explicitly defines objects, lighting, camera, composition, and style for deterministic, reproducible results"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://github.com/Bria-AI/bria-skill/blob/main/skills/image-utils/SKILL.md"},"children":["image-utils"]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Classic image manipulation - resize, crop, composite, watermarks, format conversion with Python Pillow"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"what-you-can-control","__idx":7},"children":["What You Can Control"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Capability"},"children":["Capability"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Control Level"},"children":["Control Level"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Example"},"children":["Example"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Generate images from text"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Prompt + aspect ratio + VGL structured JSON"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["\"A modern office with natural lighting, 16:9\""]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Edit specific objects"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Object-level - add, replace, or remove by name"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["\"Replace the red mug with a blue one\""]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Edit by instruction"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Image-level - natural language control"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["\"Change the mug color to red\""]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Edit masked regions"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Pixel-level - paint exactly where to change"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Inpaint only the sky, leave everything else"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Remove backgrounds"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Automatic - clean transparent PNGs"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["One API call, no manual masking"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Control lighting"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Independent - change light without touching content"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Golden hour, spotlight, dramatic shadows"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Control style"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Independent - restyle without changing structure"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Oil painting, anime, cartoon, 3D render"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Control season"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Independent - change season/weather only"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Spring blossoms, winter snow"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Expand images"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Directional - extend boundaries with context"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Outpaint to 16:9 from a square"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Product photography"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Scene control - place products in any setting"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["\"Modern kitchen countertop, morning light\""]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Upscale resolution"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["2x or 4x — preserves details"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Super resolution enhancement"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Pipeline chaining"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Multi-step - compose operations in sequence"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Generate -> remove BG -> lifestyle shot"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"example-use-cases","__idx":8},"children":["Example Use Cases"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Building a website?"]}," Ask: \"Generate a hero image for a SaaS landing page, 16:9, modern and clean\""]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["E-commerce catalog?"]}," Ask: \"Remove the background from this product photo and place it in a kitchen scene\""]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Batch assets?"]}," Ask: \"Generate product photos for these 5 items and create transparent PNGs for each\""]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Presentations?"]}," Ask: \"Create a slide visual showing data analytics, blue gradient, corporate style\""]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"alternative-installation","__idx":9},"children":["Alternative Installation"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"claude-code-direct","__idx":10},"children":["Claude Code (direct)"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"claude mcp add bria-skills -- npx -y bria-skills\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"cursor","__idx":11},"children":["Cursor"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Download the skill folders to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["~/.cursor/skills/"]},". Each skill is a folder containing a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SKILL.md"]}," file."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"manual-any-agent","__idx":12},"children":["Manual (any agent)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Copy the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["skills/"]}," directory contents to your agent's skills directory."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"requirements","__idx":13},"children":["Requirements"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Bria API key"]}," — Free at ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://platform.bria.ai/console/account/api-keys?utm_source=skill&utm_campaign=bria_skills&utm_content=readme"},"children":["platform.bria.ai"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["For image-utils:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pip install Pillow requests"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"documentation","__idx":14},"children":["Documentation"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://github.com/Bria-AI/bria-skill/tree/main/skills/bria-ai/SKILL.md"},"children":["bria-ai SKILL.md"]}," - Core skill with all capabilities"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://github.com/Bria-AI/bria-skill/tree/main/skills/bria-ai/references/api-endpoints.md"},"children":["API Endpoints Reference"]}," - Complete API documentation"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://github.com/Bria-AI/bria-skill/tree/main/skills/bria-ai/references/workflows.md"},"children":["Workflows & Pipelines"]}," - Batch generation, parallel pipelines, integration examples"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://github.com/Bria-AI/bria-skill/tree/main/skills/vgl/references/schema-reference.md"},"children":["VGL Schema Reference"]}," - Full VGL JSON schema"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://github.com/Bria-AI/bria-skill/tree/main/skills/bria-ai/references/code-examples/bria_client.py"},"children":["Python Client"]}," - Full-featured async client"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://github.com/Bria-AI/bria-skill/tree/main/skills/bria-ai/references/code-examples/bria_client.ts"},"children":["TypeScript Client"]}," - Typed Node.js client"]}]}]},"headings":[{"value":"Bria AI Skills - Controllable Image Generation for Coding Agents","id":"bria-ai-skills---controllable-image-generation-for-coding-agents","depth":1},{"value":"Quick Start","id":"quick-start","depth":2},{"value":"1. Install","id":"1-install","depth":3},{"value":"2. Get a free API key","id":"2-get-a-free-api-key","depth":3},{"value":"3. Set the key","id":"3-set-the-key","depth":3},{"value":"4. Use it","id":"4-use-it","depth":3},{"value":"Skills Included","id":"skills-included","depth":2},{"value":"What You Can Control","id":"what-you-can-control","depth":2},{"value":"Example Use Cases","id":"example-use-cases","depth":2},{"value":"Alternative Installation","id":"alternative-installation","depth":2},{"value":"Claude Code (direct)","id":"claude-code-direct","depth":3},{"value":"Cursor","id":"cursor","depth":3},{"value":"Manual (any agent)","id":"manual-any-agent","depth":3},{"value":"Requirements","id":"requirements","depth":2},{"value":"Documentation","id":"documentation","depth":2}],"frontmatter":{"seo":{"title":"Bria AI Skills - Controllable Image Generation for Coding Agents"}},"lastModified":"2026-03-20T08:50:42.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/integration-methods/bria-skill","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}