Black Forest Labs · Image

Hermes Agent x Flux

The Flux API exposes a image model from Black Forest Labs, accessible through RunAPI with a single API key and per-call billing. Developers call Flux the same way they call any other model in the RunAPI catalog — set the model parameter, submit a request, and receive structured JSON. The model skill packages docs, typed schemas, pricing notes, and setup steps so your coding agent has the right context before you write integration code. Billing is unified across all providers, failed generations are never charged, and results are retrievable by task ID.

3 variants from $0.01 / call Commercial OK
Get API Key View Hermes Agent Docs

Prerequisite: npx runapi mcp install

Prompt

Prompt models

Use flux-2-klein when it matches the task: Fastest FLUX.2 model for rapid iteration and low-latency applications.

You have access to RunAPI task tools for Flux.

Available Flux models:
- flux-2-klein: Fastest FLUX.2 model for rapid iteration and low-latency applications
  endpoints: /api/v1/flux/text_to_image
  request fields: model, prompt
- flux-dev: Efficient, guidance-distilled image generation for iterative workflows
  endpoints: /api/v1/flux/text_to_image, /api/v1/flux/remix_image
  request fields: model, prompt
- flux-pro: High-quality text-to-image with strong prompt adherence and visual detail
  endpoints: /api/v1/flux/text_to_image, /api/v1/flux/remix_image
  request fields: model, prompt

Use the model ID and endpoint that match the user's request.
Example prompt: Generate a 4K product hero image of a matte-black water bottle on a beige stone surface, soft side light.
/api/v1/flux/text_to_image: Submit the task, poll for its status, then verify the completed output. POST /api/v1/flux/text_to_image and save the returned Task id.
GET /api/v1/flux/text_to_image/<task-id> until status is completed or failed.
Verify the completed response contains the endpoint-specific output documented in the API reference.
/api/v1/flux/remix_image: Submit the task, poll for its status, then verify the completed output. POST /api/v1/flux/remix_image and save the returned Task id.
GET /api/v1/flux/remix_image/<task-id> until status is completed or failed.
Verify the completed response contains the endpoint-specific output documented in the API reference.

Public Versions and Endpoints

Model ID Endpoints Price Catalog
flux-2-klein
/api/v1/flux/text_to_image
$0.01 / call Model detail
flux-dev
/api/v1/flux/text_to_image /api/v1/flux/remix_image
$0.06 / call Model detail
flux-pro
/api/v1/flux/text_to_image /api/v1/flux/remix_image
$0.04 / call Model detail

Verify

Poll until the task reaches a terminal status

Select <model-id> to generate verification commands.

Configuration

Guide endpoint: <endpoint>

Select <model-id> to generate a request with the endpoint's public input contract.
How it works

Get Started in 3 Steps

  1. Choose a model ID

    Select a public catalog model ID and review its endpoint and current starting price.

  2. Configure RunAPI

    Set RUNAPI_API_KEY before making the endpoint request.

  3. Verify the result

    For asynchronous endpoints, poll the same endpoint until the Task reaches a terminal status.

What to Build with Hermes Agent + Flux

  • Marketing and product visuals

    Generate campaign images, product shots, and social creatives from a written brief.

  • Batch creative variations

    Produce many versions of a concept in one run to compare styles, layouts, and formats.

  • Editing and inpainting

    Refine an existing image by describing changes to its background, objects, or details where the model offers editing endpoints.

Why Use Flux Through RunAPI + Hermes Agent

  • 3 variants, one API key

    Use one RunAPI connection to choose among the live model variants without changing your integration.

  • Clear usage pricing

    See current catalog pricing before you send a request, with no subscription or minimum spend required.

  • Automatic task workflows

    Submit, poll, and collect asynchronous results through a consistent task workflow without writing manual polling code.

Hermes Agent + Flux Questions

Which Flux model should I use?

Use Flux Dev for efficient iteration, Flux Pro for the strongest prompt adherence and visual detail, and Flux 2 Klein for rapid, low-latency workflows.

Can Flux edit an existing image?

Yes. With Flux Dev or Flux Pro, the remix-image endpoint edits exactly one publicly accessible source image from text instructions and returns the same task response shape as text-to-image.

Which model ID should I use?

Choose a public model ID from the version table. Each ID exposes the endpoints shown for that version.

Does this guide configure a chat model?

No. This Model Line uses the endpoint workflow shown here and is not presented as an agent chat model.

Start using Flux with Hermes Agent

Get API Key Read Quickstart

Building with a team?

We're here to help with enterprise setup, integrations, and technical questions.

Contact Us