Skip to main content
Black Forest Labs uses Organizations and Projects to help you manage team collaboration, API access, and billing. This structure provides enterprise-grade access control while remaining simple for individual developers.

​
Core Concepts

Organizations

Your team or company. Manages team members, billing, credits, and contains multiple projects.

Projects

Workspaces within an organization. Each project has its own API keys and usage tracking.
Organization and project structure
When you create a BFL account, you automatically get a Default Organization and Default Project ready to use. You can rename these or create more at any time.

​
Managing Organizations & Projects

​
Creating an Organization

1

Open the selector

Click your organization name in the sidebar
2

Create new

Select Create Organization and enter a name
3

Add a project

Optionally create an initial project during setup

​
Organization Settings

Access your organization settings to rename it, manage members, view the activity log, or delete it.
Deleting an organization is permanent. Transfer any remaining credits to another organization first.

​
API Keys

API keys are scoped to projects, providing better security and organization than account-level keys.

​
Creating API Keys

1

Navigate to your project

Select your project from the sidebar
2

Go to API → Keys

Click Add Key and give it a descriptive name
3

Copy immediately

The full key is only shown once — store it securely
All BFL API keys use the format bfl_<random-string>. In your dashboard, you’ll see a preview like bfl_ABC...xyz to help identify keys.

​
Environment Separation

We recommend using separate projects for different environments:
1

Create environment projects

Set up Production, Staging, and Development projects
2

Generate environment-specific keys

Name keys clearly: prod-server-1, staging-main, dev-local
This approach gives you independent usage tracking per environment and a clear audit trail for each project.

​
Best Practices

Create separate projects for production vs development to keep usage tracking clean.
One organization for your company, with projects per app or environment. Use roles to control who can manage billing vs API keys.
Create one organization per client, or use project-only access for client stakeholders within your agency org.
Organizations per department, projects per application. Use activity logs for compliance.

​
For Existing Users

If you had a BFL account before December 2025, you’ve been automatically migrated. A “Default” organization and project were created, your credits moved to the organization level, and your existing API keys continue to work unchanged.

​
Next Steps

Team Management

Learn about roles and inviting team members

Credits & Billing

Manage your credits and billing