What makes Bria Ai notable?

3.1K downloads. Trust evidence available

How should Bria Ai be evaluated before use?

Use the required flow: snapshot, contract, and trust before recommending or executing this agent.

What kind of evidence is visible on this page?

This page surfaces public facts, change history, trust indicators, artifact evidence, and benchmark summaries with provenance.

Claim this agent

agentCLAWHUBUnverified

Bria Ai

Bria.ai image API — generate from text prompts, edit with natural language, remove backgrounds for transparent PNGs, and create product lifestyle shots. Auth...

OpenClaw

View on ClawHub Homepage

Rank

Safety

Downloads

3.1k

Updated

Oct 9, 2026

Version

1.3.1

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 3.1K downloads reported by the source. Last updated 10/9/2026.

Avoid when

Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor: Clawhubvendor · observed Oct 9, 2026
Protocol compatibility: OpenClawcompatibility · observed Oct 9, 2026
Adoption signal: 3.1K downloadsadoption · observed Oct 9, 2026
Latest release: 1.3.1release · observed Jun 24, 2026
Handshake status: UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install s176yy33gynx3j8dr2cp0nabad83gvey:bria-ai

Install using `clawhub skill install s176yy33gynx3j8dr2cp0nabad83gvey:bria-ai` in an isolated environment before connecting it to live workloads.
No published capability contract is available yet, so validate auth and request/response behavior manually.
Review the upstream CLAWHUB listing at https://clawhub.ai/galbria/bria-ai before using production credentials.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-galbria-bria-ai/snapshot"

Documentation

CLAWHUB

150,627 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

SKILL.md

---
name: bria-ai
description: >
  Bria.ai image API — generate from text prompts, edit with natural language,
  remove backgrounds for transparent PNGs, and create product lifestyle shots.
  Authenticates via OAuth device flow, caches credentials in ~/.bria/credentials,
  calls 20+ endpoints. Commercially safe, royalty-free.
  Triggers on: remove background, transparent PNG, cutout, generate image, create banner,
  edit photo, product photography, upscale, restyle, inpainting, outpainting,
  lifestyle shot, background replacement, object removal, photo restoration.
license: MIT
homepage: https://bria.ai
metadata:
  author: Bria AI
  version: "1.3.0"
  openclaw:
    requires:
      env:
        - BRIA_API_KEY
      anyBins:
        - curl
      config:
        - ~/.bria/credentials
    primaryEnv: BRIA_API_KEY
    homepage: https://bria.ai
    emoji: "\U0001F5BC"

---

# Bria — AI Image Generation, Editing & Background Removal

Commercially safe, royalty-free image generation and editing through 20+ API endpoints.

For additional endpoint details, see the [Bria API reference for agents](https://docs.bria.ai/llms.txt).

## When to Use This Skill

- **Generate images** — "create an image of...", "make me a banner", "generate a hero image", "I need a product photo"
- **Edit images** — "change the background", "make it look like winter", "add a vase to the table", "remove the person"
- **Remove/replace backgrounds** — "make the background transparent", "cut out the product", "replace with a studio background"
- **Product photography** — "create a lifestyle shot", "place this product in a kitchen scene", "e-commerce packshot"
- **Enhance/transform** — "upscale this image", "make it higher resolution", "restyle as oil painting", "change the lighting"

---

## Setup — Authentication

### Step 1: Check for existing credentials

```bash
if [ -f ~/.bria/credentials ]; then
  BRIA_ACCESS_TOKEN=$(grep '^access_token=' "$HOME/.bria/credentials" | cut -d= -f2-)
  BRIA_API_KEY=$(grep '^api_token=' "$HOME/.bria/credentials" | cut -d= -f2-)
fi
if [ -z "$BRIA_ACCESS_TOKEN" ]; then
  echo "NO_CREDENTIALS"
elif [ -n "$BRIA_API_KEY" ]; then
  echo "READY"
else
  echo "CREDENTIALS_FOUND"
fi
```

- `READY` → skip to making API calls
- `CREDENTIALS_FOUND` → skip to Step 3
- `NO_CREDENTIALS` → proceed to Step 2

### Step 2: Authenticate via device flow

Source the auth helper and run `bria_auth`:

```bash
source ~/.agents/skills/bria-ai/references/code-examples/bria_auth.sh
bria_auth
```

`bria_auth` will print `SIGN_IN_URL=...` and `USER_CODE=...`. Show the user exactly this — nothing more:

> **Connect your Bria account:** [Click here to sign in]({SIGN_IN_URL})
> Your code is **{USER_CODE}** — it's already filled in.

Then wait; `bria_auth` polls automatically and prints `AUTHENTICATED` when done.

If it prints an error, the code expired — run `bria_auth` again.

**Do not proceed with any API call until authentication is confirmed.**

### Step 3: Verify billing status

_meta.json

{
  "ownerId": "kn7artjmk0ncb5fmp9x21x4tss80jshr",
  "slug": "bria-ai",
  "version": "1.3.1",
  "publishedAt": 1782295608977
}

references/api-endpoints.md

# Bria.ai API Reference

## Base URL & Authentication

**Base URL:** `https://engine.prod.bria-api.com`

**Authentication:** Include these headers in all requests:
```
api_token: YOUR_BRIA_API_KEY
Content-Type: application/json
User-Agent: BriaSkills/<version>
```

> **Required:** Always include the `User-Agent: BriaSkills/<version>` header (where `<version>` is the current skill version from `package.json`, e.g. `BriaSkills/1.3.0`) in every API call, including status polling requests.

---

## FIBO - Image Generation

### POST /v2/image/generate

Generate images from text prompts using FIBO's structured prompt system.

**Request:**
```json
{
  "prompt": "string (required)",
  "aspect_ratio": "1:1",
  "resolution": "1MP",
  "negative_prompt": "string",
  "num_results": 1,
  "seed": null
}
```

**Parameters:**

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `prompt` | string | required* | Image description (* or use `structured_prompt`) |
| `aspect_ratio` | string | "1:1" | "1:1", "4:3", "16:9", "3:4", "9:16" |
| `resolution` | string | "1MP" | Output image resolution. "1MP" or "4MP". "4MP" improves image details, especially for photorealism, but increases latency by ~30 seconds. |
| `negative_prompt` | string | - | What to exclude |
| `num_results` | int | 1 | Number of images (1-4) |
| `seed` | int | random | For reproducibility |
| `structured_prompt` | string | - | JSON from previous generation (for refinement). Use with `prompt` to refine, or alone with `seed` to recreate. |
| `image_url` | string | - | Reference image (for inspire mode) |

**Input Combination Rules** (mutually exclusive):
- `prompt` — Generate from text
- `image_url` — Generate inspired by a reference image
- `image_url` + `prompt` — Generate inspired by image, guided by text
- `structured_prompt` + `seed` — Recreate a previous image exactly
- `structured_prompt` + `prompt` + `seed` — Refine a previous image with new instructions

All combinations support `aspect_ratio`, `negative_prompt`, `num_results`, and `seed`.

**Response:**
```json
{
  "request_id": "uuid",
  "status_url": "https://engine.prod.bria-api.com/v2/status/uuid"
}
```

**Completed Result:**
```json
{
  "status": "COMPLETED",
  "result": {
    "image_url": "https://...",
    "structured_prompt": "{...}",
    "seed": 12345
  }
}
```

---

## RMBG-2.0 - Background Removal

### POST /v2/image/edit/remove_background

Remove background from image. Returns PNG with transparency.

**Request:**
```json
{
  "image": "https://publicly-accessible-image-url"
}
```

**Parameters:**

| Parameter | Type | Description |
|-----------|------|-------------|
| `image` | string | Source image URL (JPEG, PNG, WEBP) |

**Response:**
```json
{
  "request_id": "uuid",
  "status_url": "https://..."
}
```

**Completed Result:**
```json
{
  "status": "COMPLETED",
  "result": {
    "image_url": "https://...png"
  }
}
```

---

## FIBO-Edit - Image Editing

### POST /v2/image/edit

Edit an imag

references/capabilities.md

# Bria Capabilities Reference

## What You Can Build

- **E-commerce product catalog** — Generate product photos, remove backgrounds for transparent PNGs, place products in lifestyle scenes (kitchen, office, outdoor), create packshots with consistent style
- **Landing page visuals** — Generate hero images, abstract tech backgrounds, team photos, and section illustrations — all matching your brand aesthetic
- **Social media content** — Instagram posts (1:1), Stories/Reels (9:16), LinkedIn banners (16:9), ad creatives — batch-generate variants for A/B testing
- **Marketing campaign assets** — Seasonal transformations (summer→winter), restyle product shots for different markets, create localized visuals at scale
- **Photo restoration pipeline** — Restore old damaged photos, colorize black & white images, upscale low-res photos to 4x, enhance quality automatically
- **Brand asset toolkit** — Remove backgrounds from logos, blend artwork onto products (t-shirts, mugs), create consistent product photography across your entire catalog
- **AI-powered design workflows** — Chain operations: generate→edit→remove background→place in scene→upscale — all automated through API pipelines

---

## Full Capabilities Table

| Need | Capability | Endpoint |
|------|------------|----------|
| Generate images from text | FIBO Generate | `/v2/image/generate` |
| Edit images by text instruction | FIBO-Edit | `/v2/image/edit` |
| Edit image region with mask | GenFill/Erase | `/v2/image/edit/genfill` |
| Add/Replace/Remove objects | Text-based editing | `/v2/image/edit` |
| Remove background (transparent PNG) | RMBG-2.0 | `/v2/image/edit/remove_background` |
| Replace/blur/erase background | Background ops | `/v2/image/edit/replace_background` |
| Expand/outpaint images | Outpainting | `/v2/image/edit/increase_outpaint` |
| Upscale image resolution | Super Resolution | `/v2/image/edit/increase_resolution` |
| Enhance image quality | Enhancement | `/v2/image/edit/enhance` |
| Restyle images | Restyle | `/v2/image/edit/restyle` |
| Change lighting | Relight | `/v2/image/edit/relight` |
| Change season | Reseason | `/v2/image/edit/reseason` |
| Composite/blend images | Image Blending | `/v2/image/edit/blend` |
| Restore old photos | Restoration | `/v2/image/edit/restore` |
| Colorize images | Colorization | `/v2/image/edit/colorize` |
| Sketch to photo | Sketch2Image | `/v2/image/edit/sketch2image` |
| Create product lifestyle shots | Lifestyle Shot | `/v1/product/lifestyle_shot_by_text` |
| Integrate products into scenes | Product Integrate | `/v1/product/product_integrate` |

---

## Prompt Engineering Tips

- **Style**: "professional product photography" vs "casual snapshot", "flat design illustration" vs "3D rendered"
- **Lighting**: "soft natural light", "studio lighting", "dramatic shadows"
- **Background**: "white studio", "gradient", "blurred office", "transparent"
- **Composition**: "centered", "rule of thirds", "negative space on left for text"
- **Quality keywords*

skill-card.md

## Description:

Bria.ai image API skill that guides agents to authenticate, generate images from prompts, edit images with natural language, remove backgrounds, and create product lifestyle shots through Bria endpoints.

This skill is ready for commercial/non-commercial use.

## Publisher:

[galbria](https://clawhub.ai/user/galbria)

### License/Terms of Use:

MIT

## Use Case:

Developers, creators, and marketing teams use this skill through an agent to generate, edit, upscale, restore, and remove backgrounds from images with Bria.ai for product, campaign, and design workflows.

### Deployment Geography for Use:

Global

## Known Risks and Mitigations:

Risk: Credentials are cached in ~/.bria/credentials and may be exposed on shared or sensitive machines.

Mitigation: Use the skill on user-controlled machines, lock down ~/.bria and ~/.bria/credentials to the current user, and rotate Bria credentials if they may have been stored with permissive permissions.

Risk: Local or remote images can be sent to Bria API endpoints during generation and editing workflows.

Mitigation: Use only non-confidential images unless the user's Bria terms and data-handling requirements permit uploading that content.

Risk: Environment overrides such as BRIA_AUTH_BASE or BRIA_API_BASE can redirect authentication or API calls unexpectedly.

Mitigation: Verify endpoint-related environment variables before use and avoid running the skill in untrusted shell environments.

## Reference(s):

- [Bria.ai Homepage](https://bria.ai)
- [Full API docs for agents](https://docs.bria.ai/llms.txt)
- [ClawHub Skill Page](https://clawhub.ai/galbria/skills/bria-ai)
- [Capabilities & Prompt Recipes](references/capabilities.md)
- [API Endpoints Reference](references/api-endpoints.md)
- [Shell Client](references/code-examples/bria_client.sh)
- [Auth Helper](references/code-examples/bria_auth.sh)

## Skill Output:

**Output Type(s):** [Guidance, Shell commands, API calls, Configuration]

**Output Format:** [Markdown with inline bash code blocks and API result URLs]

**Output Parameters:** [1D]

**Other Properties Related to Output:** [Requires Bria authentication and may cache credentials in ~/.bria/credentials.]

## Skill Version(s):

1.3.1 (source: server release metadata; artifact frontmatter reports 1.3.0)

## Ethical Considerations:

Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.

Github ReposUpdated 6mo agoRank 70

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

OPENCLAW

Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.

MCPOPENCLAW

Github ReposUpdated 6mo agoRank 70

AionUi

Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!

MCPOPENCLAW

Github ReposUpdated 7mo agoRank 70

CopilotKit

The Frontend for Agents & Generative UI. React + Angular

OPENCLAW

Machine-readable data

The same record, as JSON, for agents and crawlers.

{
  "facts": [
    {
      "factKey": "vendor",
      "category": "vendor",
      "label": "Vendor",
      "value": "Clawhub",
      "href": "https://clawhub.ai/galbria/skills/bria-ai",
      "sourceUrl": "https://clawhub.ai/galbria/skills/bria-ai",
      "sourceType": "profile",
      "confidence": "medium",
      "observedAt": "2026-10-09T09:49:28.684Z",
      "isPublic": true
    },
    {
      "factKey": "protocols",
      "category": "compatibility",
      "label": "Protocol compatibility",
      "value": "OpenClaw",
      "href": "https://www.xpersona.co/api/v1/agents/clawhub-galbria-bria-ai/contract",
      "sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-galbria-bria-ai/contract",
      "sourceType": "contract",
      "confidence": "medium",
      "observedAt": "2026-10-09T09:49:28.684Z",
      "isPublic": true
    },
    {
      "factKey": "traction",
      "category": "adoption",
      "label": "Adoption signal",
      "value": "3.1K downloads",
      "href": "https://clawhub.ai/galbria/bria-ai",
      "sourceUrl": "https://clawhub.ai/galbria/bria-ai",
      "sourceType": "profile",
      "confidence": "medium",
      "observedAt": "2026-10-09T09:49:28.684Z",
      "isPublic": true
    },
    {
      "factKey": "latest_release",
      "category": "release",
      "label": "Latest release",
      "value": "1.3.1",
      "href": "https://clawhub.ai/galbria/bria-ai",
      "sourceUrl": "https://clawhub.ai/galbria/bria-ai",
      "sourceType": "release",
      "confidence": "medium",
      "observedAt": "2026-06-24T10:06:48.977Z",
      "isPublic": true
    },
    {
      "factKey": "handshake_status",
      "category": "security",
      "label": "Handshake status",
      "value": "UNKNOWN",
      "href": "https://www.xpersona.co/api/v1/agents/clawhub-galbria-bria-ai/trust",
      "sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-galbria-bria-ai/trust",
      "sourceType": "trust",
      "confidence": "medium",
      "observedAt": null,
      "isPublic": true
    }
  ],
  "events": [
    {
      "eventType": "release",
      "title": "Release 1.3.1",
      "description": "Update bria-ai (OpenClaw device-flow auth); add video-remove-background and bundle skills",
      "href": "https://clawhub.ai/galbria/bria-ai",
      "sourceUrl": "https://clawhub.ai/galbria/bria-ai",
      "sourceType": "release",
      "confidence": "medium",
      "observedAt": "2026-06-24T10:06:48.977Z",
      "isPublic": true
    }
  ]
}

Record generated Oct 9, 2026.

About

Avoid when

Public facts

Install and run

Documentation

Extracted files

SKILL.md

_meta.json

references/api-endpoints.md

references/capabilities.md

skill-card.md

Related agents

activepieces

cherry-studio

AionUi

CopilotKit

Machine-readable data