# Bria API (slim)

> Bria's API generates and edits images with its FIBO models, trained on licensed data. It runs as an asynchronous REST API with Python and TypeScript SDKs and an MCP server.

- Full: https://www.anchorterminal.com/tools/bria.md (~6,900 tokens) · this version ~1,730 tokens · JSON https://www.anchorterminal.com/tools/bria.json · canonical https://www.anchorterminal.com/tools/bria
- Index: https://www.anchorterminal.com/llms.txt · API: https://www.anchorterminal.com/api/v1/index.json · Updated: 2026-10-08

**B · 63.7/100 · rank #298 of 722 · #4 in Image generation · not agent-ready · confidence medium**


Assessment: Per-image prices, 100 free calls without a card, OpenAPI files and Markdown docs make a first call quick, and the terms warrant that customer content is not used for training. Keys are organisation-wide with no scopes, and the API has no changelog or deprecation policy.

## Facts

- Kind: Model API · vendor: Bria AI · category: Image generation · legal entity: Bria Artificial Intelligence Ltd. · provenance 56/100
- Endpoint: `https://engine.prod.bria-api.com/v2` (HTTP, Streamable HTTP, stdio)
- Auth: OAuth or key · pricing: Freemium · x402: no · licence: unknown
- Probe metrics: not measured yet (probes haven't run)
- Models: Own models. FIBO (default) and FIBO Lite for generation, FIBO Edit for instruction editing, RMBG 2.0 for background removal
- Max resolution: `resolution` is 1MP or 4MP on `/v2/image/generate`. 4MP is asynchronous only and adds about 30 seconds, per the docs. Nine aspect ratios from 9:16 to 16:9. Output PNG or JPEG
- Edit support: Instruction editing with 1 to 4 images and an optional mask, erase, generative fill, expand, background removal, replacement and blur, relight, restyle, colourise, restore, enhance, increase resolution, product shots and virtual try-on
- Output licence: Bria assigns its rights in output to the customer. Output may not be used to train generative models or placed in a public image bank (Online Terms and Conditions, sections 2.1 and 2.3)
- Content policy: Models trained without public figures, fictional characters or NSFW content, per Bria. Moderation of prompts and images is opt-in per request and returns 422. `ip_signal` adds a warning for prompts naming protected content
- Provenance: C2PA manifest and an invisible watermark on output. Public verification endpoints `POST /v2/image/verify` and `POST /v2/video/verify` need no token
- Open weights: FIBO, FIBO Edit, FIBO Lite and RMBG 2.0 on Hugging Face, source-available for non-commercial use
- Free tier: 100 free calls, no card, every endpoint, 10 requests a minute
- Rate limits: Per organisation and per endpoint. Free 10 requests a minute, Pay-as-you-go 60, Enterprise 1,000 and customisable. Status polls count
- Result storage: Image URLs expire after 3 days by default, video does not expire, Ad Delayer results 30 days, legacy `/v1/product/*` results 1 hour. Inputs are not retained beyond processing, per the docs
- MCP server: Hosted at https://mcp.prod.bria-api.com/mcp (Streamable HTTP, `api_token` header or OAuth 2.1 with PKCE and dynamic client registration) or local with `uvx bria-mcp`. 18 tools in `bria-mcp` 2.2.1
- Prices: FIBO generation $0.03 per image; FIBO Lite generation $0.02 per image; FIBO Edit $0.03 per image; Background removal $0.018 per image; Increase resolution $0.02 per image; Structured prompt $0.02 per call; Video background removal $0.0225 per second of video

- Scores: Reliability 83, Performance pending, Schema & documentation 84, Agent ergonomics 76, Security & auth 33, Payments & pricing 40, Task success pending, Maintenance & community 69, Transparency & trust 49 · total over the 7 assessed categories
- Why: Reliability, Read with the hosted lines. · Schema & documentation, A downloadable OpenAPI 3.0 file for each API, such as `/_bundle/image-generation.yaml` (25). · Agent ergonomics, Results come back as URLs, with a `seed` and the full structured prompt. · Security & auth, Several named, revocable organisation keys with no scopes, plus OAuth 2.1 with PKCE on the hosted MCP server, where the scopes are identity… · Payments & pricing, No x402, MPP or L402 (0). · Maintenance & community, `bria-mcp` 2.2.1 on 4 October 2026, four days before the check (30). · Transparency & trust, Closed hosted API under the Online AI General Terms and Conditions of March 2025, a PDF linked from the website terms.
- Sources: 26, open questions: 8, both in the full twin
- Capabilities: image.generate, image.edit, image.upscale, image.reference
- JSON: https://www.anchorterminal.com/api/v1/tools/bria.json
- Verify (for the vendor): the badge `https://www.anchorterminal.com/badges/bria.svg` or a link to https://www.anchorterminal.com/tools/bria from a page on bria.ai or one of its subdomains, or the README of github.com/Bria-AI/bria-client, then `POST https://www.anchorterminal.com/api/v1/verify` `{"slug", "url"}` or `verify_listing` at /mcp; re-checked weekly, no effect on the grade. Snippets in the full twin.

## Before you call it

1. Send the key in the `api_token` header, not as `Authorization: Bearer`. Only `/v2/image/verify` and `/v2/video/verify` work without it
2. Expect `202` with `request_id` and `status_url` from v2 endpoints. Poll `GET /v2/status/{request_id}` every 1 to 2 seconds, or pass `sync: true`
3. Status polls count towards the per-endpoint limit (10 a minute on Free, 60 on Pay-as-you-go), so prefer `webhook_url` for batches
4. Download results promptly. Image URLs expire after 3 days by default, and legacy `/v1/product/*` results after 1 hour
5. Do not resend a failed `POST` blindly. There is no idempotency key, and the SDKs retry status polls only

## Connect

```bash
pip install bria-client
```

```bash
curl -X POST https://engine.prod.bria-api.com/v2/image/generate \
  -H "api_token: $BRIA_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "a serene mountain landscape at dawn", "aspect_ratio": "1:1"}'
```

```bash
claude mcp add --transport http bria https://mcp.prod.bria-api.com/mcp \
  --header "api_token: $BRIA_API_TOKEN"
```

## Similar tools

| Tool | Grade | Score | Shared capabilities | Slim |
| --- | --- | --- | --- | --- |
| fal image models | B | 65.2 | image.generate, image.edit, image.upscale, image.reference | https://www.anchorterminal.com/tools/fal-image.min.md |
| Recraft API | D | 52.8 | image.generate, image.edit, image.upscale, image.reference | https://www.anchorterminal.com/tools/recraft.min.md |
| Replicate image models | D | 50.2 | image.generate, image.edit, image.upscale, image.reference | https://www.anchorterminal.com/tools/replicate-image.min.md |
| Ideogram API | D | 50 | image.generate, image.edit, image.upscale, image.reference | https://www.anchorterminal.com/tools/ideogram.min.md |
| Adobe Firefly API | D | 49 | image.generate, image.edit, image.upscale, image.reference | https://www.anchorterminal.com/tools/adobe-firefly.min.md |


## Panel reviews (0, desk reviews from public material, no calls made)