# Bria AI API > bria.ai helps you build products and workflows by delivering controllable, easy-to-integrate and safe generative visual AI capabilities. Bria enables developers to generate and edit high-quality visual content at scale with predictable, consistent, and legally compliant results. Every output is commercially licensed - no copyright risk, no legal gray areas. Key facts: - Async V2 API: most endpoints return `request_id` + `status_url` for polling - Auth: include `api_token` header in all requests - Rate limits: Free Trial (10/min), Starter (60/min), Enterprise/Custom (100+/min) - 429 errors include structured recovery directives for agent consumption - All requests must include header `User-Agent: BriaPlatform/APIdocs/LLMsAgent` - Get your API token: https://platform.bria.ai/organization-management/api-keys Per-endpoint API schemas (full input/output schemas, code examples, and sandbox links): https://platform.bria.ai/llms.txt ## Integrations MCP server, Claude Skill, and Python SDK. - [Bria MCP Overview](https://docs.bria.ai/mcp-authentication.md) - [Bria AI Skills - Controllable Image Generation for Coding Agents](https://docs.bria.ai/integration-methods/bria-skill.md) - [Bria Client](https://docs.bria.ai/integration-methods/python-sdk.md) ## Getting Started Authentication, API overview, and platform concepts. - [Bria Products Overview](https://docs.bria.ai/products-overview.md) - [Enterprise-Grade Safety and Transparency by Design](https://docs.bria.ai/safety.md) - [Bria Best Practices Overview](https://docs.bria.ai/best-practices-overview.md) - [BRIA AI API](https://docs.bria.ai/index.html.md) ## Image Generation Generate images using text prompts or structured JSON via FIBO models. - [Image Generation API Reference](https://docs.bria.ai/image-generation.md): Below you will find the technical specifications, request schemas, and response models for our endpoints. Choose an endpoint from the sidebar to view code samples and run test requests. ## Image Editing Edit, transform, and enhance images with 20+ specialized endpoints. - [Image Editing API Reference](https://docs.bria.ai/image-editing.md): Below you will find the technical specifications, request schemas, and response models for our endpoints. Choose an endpoint from the sidebar to view code samples and run test requests. ## Video Editing Remove backgrounds (REST async or real-time streaming), erase objects, upscale, and generate masks for video. - [Local Video Upload Service](https://docs.bria.ai/local-video-upload-service.md) - [Realtime Video Background Removal API](https://docs.bria.ai/streaming-rmbg.md) - [Video API Reference](https://docs.bria.ai/video-editing.md): Bria's Video APIs empower builders with powerful tools for programmatically transforming video content while maintaining original quality. The Video API is organized into two transport paradigms: - **REST API (Async)** — Standard HTTP request/response. You submit a job, receive a `request_id` and `status_url`, and poll the [Status Service](https://docs.bria.ai/status) until the job completes. Use this for editing, masking, and most batch-style workflows. - **Streaming API (WebSocket)** — Persistent bidirectional connection for low-latency, frame-by-frame processing. Use this when you need real-time output (e.g., live video feeds, interactive previews). **Asynchronous Requests and the Status Service** Bria API v2 REST endpoints process requests asynchronously by default. When you make an asynchronous request, the API immediately returns a `request_id` and a `status_url` instead of the final result. Use the Status Service to track the request's progress until it reaches a completed state. See the full guide at [Status Service Documentation](https://docs.bria.ai/status) for complete details and usage examples. ## Product Shot Editing SKU packshots, lifestyle scenes, and automotive product imagery. - [Product Shot API Reference](https://docs.bria.ai/product-shot-editing.md): Below you will find the technical specifications, request schemas, and response models for our endpoints. Choose an endpoint from the sidebar to view code samples and run test requests. ## Optional Ads, image onboarding, and attribution. - [Ads Generation API Reference](https://docs.bria.ai/ad-generation.md): Bria's Ads Generation API enables builders to create multiple ads (scenes) in various sizes and resolutions, all unified by the same branding, style, and messaging. You can start exploring immediately with our public templates and brands. For creating your own private templates and brands, please [Contact Us](https://bria.ai/contact-us). **Getting Started with Public Assets** You can start exploring the API immediately using our public templates and brands, with no setup required. * **Public Template IDs**: * **`1062`**: A template that requires a brand ID. * **`1061`**: A brand-independent template (does not require a brand ID). * **Public Brand IDs**: **`167`**, **`166`**, **`122`**, **`121`**, **`120`**. These can be used for testing with compatible templates like **`1062`**. * **Important**: Public templates and brands can only be used with each other and cannot be mixed with private assets. The Ads Generation API provides a set of endpoints to manage the assets needed for ads generation: 1. **Templates**: Pre-designed ad layouts that can be reused and customized: - Access template libraries and their configurations - Each template contains multiple scenes with customizable elements - Templates can be created using BRIA's Ads Editor 2. **Brands**: Define and manage brand assets: - Store and retrieve brand-specific elements like logos, colors, and fonts - Ensure brand consistency across all generated ads 3. **Ads Generation**: Create ads using templates and brand assets: - Customize text, images, and smart image backgrounds - Generate multiple ad variations at scale - Configure scene-specific elements and properties - [Bria Attribution Service API Reference](https://docs.bria.ai/bria-attribution-service.md): The Bria **Attribution Service** enables developers to integrate Bria’s patented attribution technology, ensuring transparent compensation to content owners for their contributions to AI-generated outputs. This service supports both **Image** and **Video** assets via two integration architectures: **Attribution with No Compute Cost**, where assets are sent directly to Bria for processing. **Attribution with Full Data Privacy**, where the Attribution Model is hosted within your environment and only irreversible vectors (embeddings) are shared with Bria. - [Image Onboarding API Reference](https://docs.bria.ai/image-onboarding.md): Bria's Image Onboarding API allows registering images to Bria without database storage. It provides a simple way to obtain a visual identifier (visual_id) needed for specific Bria features like AI Search and the Image Editing Create endpoint. Images can be registered using either publicly accessible URLs or internal image keys. The API also includes functionality to remove registered images from your organization's gallery when needed.