{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition","tabs","tab"]},"type":"markdown"},"seo":{"title":"Self-hosted models","description":"Generate and edit images and video with Bria's Fibo models through a REST API, Python and TypeScript SDKs, MCP server and agent skills. Licensed training data, controllable output, provenance on every result.","siteUrl":"https://docs.bria.ai","image":"/assets/bria-social-card.5f3c59395e7b5efa776984c64ef9cb0956b1d651f45b7ebf9502122a66054f35.db81178d.png","llmstxt":{"hide":false,"title":"Bria API documentation","description":"Bria's developer platform: controllable, commercially safe visual generative AI (images and video) as a REST API, Python and TypeScript SDKs, MCP server and agent skills.","details":{"path":"_llmstxt-details.md"},"sections":[{"title":"Getting started","description":"First call, authentication, async jobs and webhooks, rate limits, inputs.","includeFiles":["index.md","whats-new/fibo-2.md","getting-started/quickstart.md","getting-started/authentication.md","getting-started/async-requests.md","status.yaml","getting-started/rate-limits-and-errors.md","getting-started/working-with-images.md","getting-started/asset-retention.md"]},{"title":"Integrate","description":"Python SDK, TypeScript SDK, MCP server, agent skills, and machine-readable docs for agents.","includeFiles":["integration-methods/python-sdk.md","integration-methods/typescript-sdk.md","MCP-authentication.md","integration-methods/bria-skill.md","integration-methods/for-ai-agents.md"]},{"title":"Concepts","description":"Platform map, VGL and the Fibo models, safety, best practices.","includeFiles":["products-overview.md","VGL.md","safety.md","best-practices-overview.md","image-generation-best-practices.md","image-editing-best-practices.md","product-shots-best-practices.md"]},{"title":"Image Generation","description":"Generate images from text, reference images or structured (VGL) prompts with Fibo 2.","includeFiles":["image-generation-overview.md","image-generation.yaml"]},{"title":"Image Editing","description":"Instruction-based editing plus specialized endpoints for backgrounds, erasing, fill, expansion, upscaling and style.","includeFiles":["image-editing-overview.md","image-editing.yaml"]},{"title":"Product Shot Editing","description":"Cutouts, packshots, shadows, lifestyle scenes, product integration, holding, virtual try-on, automotive.","includeFiles":["product-shot-overview.md","product-shot-editing.yaml"]},{"title":"Video Editing","description":"Background removal (REST or real-time streaming), erasing, upscaling and masks for video; local video upload.","includeFiles":["video-editing-overview.md","local-video-upload-service.md","streaming-rmbg.md","video-editing.yaml"]},{"title":"Ads","description":"Finished ads as input. Ad Delayer turns one into editable layers (the guide holds the layer document contract); Ad Resize produces it at other sizes with the layout redone.","includeFiles":["ads-overview.md","ads.yaml"]},{"title":"Trust and provenance","description":"Public verification of Bria provenance, and attribution of outputs to licensed training data.","includeFiles":["trust-and-provenance-overview.md","visual-verification-overview.md","visual-verification.yaml","enterprise/attribution.md","bria-attribution-service.yaml"]},{"title":"Self-hosting","description":"Run licensed Bria models on your own GPUs. Buy a per-model license, install with Bria Studio or the Python library, run, and handle license errors.","includeFiles":["self-hosted/quickstart.md","self-hosted/overview.md","self-hosted/best-practices.md","self-hosted/fibo-2.md","self-hosted/rmbg-2.md"]},{"title":"Enterprise","description":"Run Bria in your own cloud or on-premises.","includeFiles":["enterprise/deployment-options.md"]}],"excludeFiles":["_llmstxt-details.md","README.md"]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"self-hosted-models","__idx":0},"children":["Self-hosted models"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A self-hosted license lets you run a Bria model on your own GPUs instead of calling Bria's cloud. You buy one license per model, install the model's package, and run it from your own services. Your images and video never leave your environment, and the weights come from Bria directly — you never need a Hugging Face account."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"You need a license"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each model is licensed on its own. Buy a license from the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://platform.bria.ai/licensing/pricing"},"children":["pricing page"]},", then manage it on the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://platform.bria.ai/organization-management/licensing"},"children":["Licenses tab"]}," in the Bria Console. Companies with revenue under $10M can buy Starter and Scale by card; larger companies and custom needs go through ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://bria.ai/contact-us"},"children":["Bria sales"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-it-works","__idx":1},"children":["How it works"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["License."]}," Buy a per-model license in the Console. A license is a subscription in your billing account — nothing is installed by buying it."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Install."]}," On your own machine, install the model's package and download its weights. The fastest way is ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#set-it-up"},"children":["Bria Studio"]},"; you can also install the Python library directly."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Run."]}," Load the model with one of your API keys and run it. Every generation is counted against your license and shown in the Console."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"available-models","__idx":2},"children":["Available models"]},{"$$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":"Model"},"children":["Model"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"What it does"},"children":["What it does"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Guide"},"children":["Guide"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Fibo 2"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Image generation and editing"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/self-hosted/fibo-2"},"children":["Fibo 2"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["RMBG 2.0"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Background removal for images"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/self-hosted/rmbg-2"},"children":["RMBG 2.0"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["More models are on the way. The ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://platform.bria.ai/licensing/pricing"},"children":["pricing page"]}," shows the full launch list and marks which are available today."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"set-it-up","__idx":3},"children":["Set it up"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Two ways to install a licensed model — Bria Studio, or a manual install with one of your ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/getting-started/authentication"},"children":["API keys"]},":"]},{"$$mdtype":"Tag","name":"Tabs","attributes":{"size":"medium"},"children":[{"$$mdtype":"Tag","name":"TabItemFragment","attributes":{"label":"Bria Studio (recommended)","disable":false},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Installs the model, downloads the weights, and runs a test. Needs ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://nodejs.org"},"children":["Node.js"]}," and a GPU."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"npx @bria-ai/studio\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Studio signs you in through your browser (no token to copy) and lists your licensed models. See the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/self-hosted/quickstart"},"children":["quickstart"]},"."]}]},{"$$mdtype":"Tag","name":"TabItemFragment","attributes":{"label":"Manual (Docker, CI)","disable":false},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Exchange one of your API keys for a short-lived registry credential, then install the model's package:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"export BRIA_API_TOKEN=\"<your-bria-api-token>\"\n\n# Use the model's repository: bria-remove-bg (RMBG 2.0) or bria-fibo-2 (Fibo 2).\nCA=$(curl -s \"https://engine.prod.bria-api.com/v2/outpost/access/code_artifact?repository=bria-remove-bg\" \\\n      -H \"api_token: $BRIA_API_TOKEN\" | jq -r '.result.authorization_token')\n\npip install --upgrade \"remove_bg>=0.5.0\" \\\n  --extra-index-url \"https://aws:$CA@bria-300465780738.d.codeartifact.us-east-1.amazonaws.com/pypi/bria-remove-bg/simple/\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Full run example and a Dockerfile are in each model's guide: ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/self-hosted/fibo-2"},"children":["Fibo 2"]},", ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/self-hosted/rmbg-2"},"children":["RMBG 2.0"]},"."]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"licensing-and-usage","__idx":4},"children":["Licensing and usage"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Any of your API keys works."]}," No separate license key — manage keys on the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://platform.bria.ai/organization-management/api-keys"},"children":["API keys page"]}," and set one as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["BRIA_API_TOKEN"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Usage shows in the Console."]}," Self-hosted runs appear in ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Usage & billing"]},", tagged as self-hosted."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["A lapsed license stops new runs."]}," A cancelled or ended license refuses new starts; a running process continues until its next restart. A card retry (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["past_due"]},") stays active."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Buying a license never blocks the API."]}," License and API plan are separate. With no API plan, a license moves you to pay-as-you-go; an existing plan is unchanged."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"enterprise-and-on-premises","__idx":5},"children":["Enterprise and on-premises"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Self-hosted licenses run the published model version on your own cloud GPUs. For air-gapped or on-premises deployments, full-precision models, automatic upgrades, an SLA, or custom models, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/enterprise/deployment-options"},"children":["Deployment options"]}," or ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://bria.ai/contact-us"},"children":["contact sales"]},"."]}]},"headings":[{"value":"Self-hosted models","id":"self-hosted-models","depth":1},{"value":"How it works","id":"how-it-works","depth":2},{"value":"Available models","id":"available-models","depth":2},{"value":"Set it up","id":"set-it-up","depth":2},{"value":"Licensing and usage","id":"licensing-and-usage","depth":2},{"value":"Enterprise and on-premises","id":"enterprise-and-on-premises","depth":2}],"frontmatter":{"title":"Self-hosted models","description":"Run licensed Bria models on your own servers. Buy a per-model license, install with Bria Studio or the Python library, and see usage in the Bria Console.","seo":{"title":"Self-hosted models"}},"lastModified":"2026-10-20T15:06:45.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/self-hosted/overview","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}