bria-ai

Files (6)

• LICENSE.txt
• SKILL.md
• api-endpoints.md · references/
• capabilities.md · references/
• bria_auth.sh · references/code-examples/
• bria_client.sh · references/code-examples/

SKILL.md (first lines)

# 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 and resolve API key

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

Interpret output:
- `BILLING_ERROR: ...` — relay the message to the user verbatim and **stop**. Do not make any API calls.
- `TOKEN_EXPIRED` — tell the user their session expired and restart from Step 2.
- `READY` — `BRIA_API_KEY` is now cached in `~/.bria/credentials`. Proceed.

---

## Decision Tree — Which Endpoint to Use

```
Transparent PNG / cutout / remove background?
  → /v2/image/edit/remove_background

Generate image from scratch (text → image)?
  → /v2/image/generate

Edit existing image with text instruction?
  → /v2/image/edit  (use --key images)

Combine 2-4 images — outfit, product, logo, style, or background from one into another?
  → /v2/image/edit  (--key images, then one --image per extra reference)

Remove an object and its shadow or reflection ("remove the bike and its shadow")?
  → /v2/image/edit/erase  ("composite": false, mask only the object)

Change / replace / blur background?
  → /v2/image/edit/replace_background  (prompt: "blur" or describe new bg)

Place product in a lifestyle scene?
  → /v1/product/lifestyle_shot_by_text

Upscale / increase resolution?
  → /v2/image/edit/increase_resolution  (scale: 2 or 4)

Anything else (restyle, relight, reseason, restore, colorize, sketch, blend, outpaint)?
  → See references/capabilities.md for the full endpoint list
```

---

## How to Call Any Endpoint

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

# Generate (no image input)
RESULT=$(bria_call /v2/image/generate "" '"prompt": "your description", "aspect_ratio": "16:9", "sync": true')

# Generate with a photographic look (style: kodak_film, hard_flash, hazy_dreamy or rough_realism)
RESULT=$(bria_call /v2/image/generate "" '"prompt": "a woman reading on a city bus", "style": "kodak_film", "seed": 5555, "sync": true')

# Remove background
RESULT=$(bria_call /v2/image/edit/remove_background "/path/to/local/image.png")

From Bria-AI/bria-skill, MIT.

More from Bria-AI/bria-skill