Flux website screenshot

Flux

An open-source text-to-image AI model developed by Black Forest Labs that generates high-quality images from text prompts with improved prompt following and visual quality.

Flux publishes 3 APIs on the APIs.io network: Editing API, Generation API, and Results API. Tagged areas include AI, Image Generation, Machine Learning, Open Source, and Text to Image.

The Flux catalog on APIs.io includes 1 JSON-LD context and 1 Spectral governance ruleset.

Flux’s developer surface includes authentication, documentation, getting-started guide, engineering blog, changelog, signup flow, and 11 more developer resources.

59.4/100 strong ▬ flat Agent 49/100 agent ready Full breakdown ↓
scored 2026-07-28 · rubric v0.6
AccessFreemiumSelf serve⚡ Free to try
3 APIs 1 MCP Servers
AIImage GenerationMachine LearningOpen SourceText to Image

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-07-28 · rubric v0.6
Composite quality — 59.4/100 · strong
Contract Quality 17.8 / 25
Developer Ergonomics 9.1 / 20
Commercial Clarity 12.1 / 20
Operational Transparency 6.8 / 13
Governance 7.0 / 12
Discoverability 6.5 / 10
Agent readiness — 49/100 · agent ready
Machine-Readable Contract 18 / 18
Agentic Access Contract 10 / 10
MCP Server 12 / 12
Machine-Readable Auth 10 / 10
Idempotency 0 / 9
Stable Error Semantics 8 / 8
Request/Response Examples 0 / 7
Rate-Limit Signaling 7 / 7
Typed Event Surface 0 / 6
Agent Skills 0 / 5
Well-Known Catalog 0 / 4
Consent & Bot Identity 0 / 3
A2A Agent Card 0 / 8
Dry-Run / Simulate Mode 0 / 4
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/flux: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 3

Individual APIs this provider publishes, each with its own machine-readable definition.

Flux Editing API

Endpoints for submitting image editing requests using FLUX.1 Kontext models. Accepts an input image and a text instruction to produce a transformed output image.

Flux Generation API

Endpoints for submitting image generation requests using FLUX models. Each endpoint targets a specific model variant and returns a task ID for polling.

Flux Results API

Endpoints for polling the status and retrieving completed image editing results.

Postman Collections 3

Ready-to-run Postman collections for exercising this provider's APIs.

Open Collections 2

Open, tool-agnostic API collections (OpenAPI-derived and Bruno).

Flux Image Editing API

OPEN COLLECTION

Flux Image Generation API

OPEN COLLECTION

MCP Servers 1

Model Context Protocol servers that expose these APIs to AI agents.

MCP Server

MCP SERVER

Pricing Plans 1

Published pricing tiers and plan structures.

Flux Plans Pricing

3 plans

PLANS

Rate Limits 1

Documented rate limits and quota policies.

Flux Rate Limits

5 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

Flux Finops

FINOPS

Semantic Vocabularies 1

JSON-LD contexts and semantic vocabularies used across these APIs.

Flux Context

0 classes · 5 properties

JSON-LD

Spectral Rules 1

Spectral governance rulesets for linting and validating these APIs.

Flux API Rules

6 rules · 5 warnings 1 info

SPECTRAL

JSON Schema 1

Standalone JSON Schema definitions for this provider's data models.

Flux Image Generation Request

11 properties

JSON SCHEMA

Security Posture 2

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Flux Authentication

apiKey · 1 scheme

SECURITY

Flux Domain Security

TLSv1.3 · HSTS · DMARC

SECURITY

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Flux Agentic Access

9 operations · 7 acting

9 operations · 7 acting

AGENTIC

Resources

Get Started 2

Portal, sign-up, and the first successful call

Documentation 2

Reference material describing how the API behaves

Agent Surfaces 2

MCP servers, agent skills, and machine-readable catalogs

Design & Contract 1

Pagination, idempotency, versioning, errors, and events

Build 3

SDKs, sample code, and the tooling you integrate with

Access & Security 2

Authentication, authorization, and security posture

Operate 1

Status, limits, changes, and where to get help

Commercial 2

Pricing, plans, and the legal terms of use

Company 2

The organization behind the API

Source (apis.yml)

apis.yml Raw ↑
aid: flux
name: Flux
description: An open-source text-to-image AI model developed by Black Forest Labs that generates high-quality images from
  text prompts with improved prompt following and visual quality.
type: Index
accessModel:
  pricing: freemium
  onboarding: self-serve
  trial: false
  try_now: true
  public: false
  label: Freemium · Self-serve signup
  confidence: high
  source:
  - plans
  - authentication
  generated: '2026-07-22'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/flux.png
url: https://raw.githubusercontent.com/api-evangelist/flux/refs/heads/main/apis.yml
created: '2025-01-01'
modified: '2026-05-19'
specificationVersion: '0.19'
tags:
- AI
- Image Generation
- Machine Learning
- Open Source
- Text to Image
apis:
- aid: flux:flux-editing-api
  name: Flux Editing API
  description: Endpoints for submitting image editing requests using FLUX.1 Kontext models. Accepts an input image and a text
    instruction to produce a transformed output image.
  humanURL: https://docs.bfl.ai/
  baseURL: https://api.bfl.ai/v1
  tags:
  - Editing
  properties:
  - type: OpenAPI
    url: openapi/flux-editing-api-openapi.yml
  - type: Documentation
    url: https://docs.bfl.ai/
  - type: GettingStarted
    url: https://docs.bfl.ml/quick_start/generating_images
  - type: Authentication
    url: https://docs.bfl.ai/
  - type: JSONSchema
    url: json-schema/flux-generation-request-schema.json
  - type: Documentation
    url: https://docs.bfl.ml/kontext/kontext_image_editing
- aid: flux:flux-generation-api
  name: Flux Generation API
  description: Endpoints for submitting image generation requests using FLUX models. Each endpoint targets a specific model
    variant and returns a task ID for polling.
  humanURL: https://docs.bfl.ai/
  baseURL: https://api.bfl.ai/v1
  tags:
  - Generation
  properties:
  - type: OpenAPI
    url: openapi/flux-generation-api-openapi.yml
  - type: Documentation
    url: https://docs.bfl.ai/
  - type: GettingStarted
    url: https://docs.bfl.ml/quick_start/generating_images
  - type: Authentication
    url: https://docs.bfl.ai/
  - type: JSONSchema
    url: json-schema/flux-generation-request-schema.json
  - type: Documentation
    url: https://docs.bfl.ml/kontext/kontext_image_editing
- aid: flux:flux-results-api
  name: Flux Results API
  description: Endpoints for polling the status and retrieving completed image editing results.
  humanURL: https://docs.bfl.ai/
  baseURL: https://api.bfl.ai/v1
  tags:
  - Results
  properties:
  - type: OpenAPI
    url: openapi/flux-results-api-openapi.yml
  - type: Documentation
    url: https://docs.bfl.ai/
  - type: GettingStarted
    url: https://docs.bfl.ml/quick_start/generating_images
  - type: Authentication
    url: https://docs.bfl.ai/
  - type: JSONSchema
    url: json-schema/flux-generation-request-schema.json
  - type: Documentation
    url: https://docs.bfl.ml/kontext/kontext_image_editing
common:
- type: PostmanWorkspace
  url: https://www.postman.com/kinlaneapi/flux/overview
- type: AgenticAccess
  url: agentic-access/flux-agentic-access.yml
- type: DomainSecurity
  url: security/flux-domain-security.yml
- type: Authentication
  url: authentication/flux-authentication.yml
- type: JSONLD
  url: json-ld/flux-context.jsonld
- type: JSONSchema
  url: json-schema/flux-generation-request-schema.json
- type: Website
  url: https://bfl.ai/
- type: Documentation
  url: https://docs.bfl.ai/
- type: GettingStarted
  url: https://docs.bfl.ml/quick_start/generating_images
- type: GitHubOrganization
  url: https://github.com/black-forest-labs
- type: GitHubRepository
  url: https://github.com/black-forest-labs/flux
- type: Blog
  url: https://bfl.ai/blog
- type: ChangeLog
  url: https://docs.bfl.ai/release-notes
- type: TermsOfService
  url: https://bfl.ai/legal/flux-api-service-terms
- type: PrivacyPolicy
  url: https://bfl.ai/legal/privacy-policy
- type: Signup
  url: https://auth.bfl.ai/register
- name: MCP Server
  url: https://github.com/black-forest-labs/flux-mcp
  type: MCPServer
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com