Black Forest Labs · Image

Hermes Agent x Flux Kontext

Flux Kontext is Black Forest Labs' context-aware editing model, built on the 12B-parameter Flux architecture. Through RunAPI, both Kontext Pro and Max variants share a single key.

2 variants from $0.11 / call Commercial OK
Get API Key View Hermes Agent Docs

Prerequisite: npx runapi mcp install

Prompt

Prompt models

Use flux-kontext-max when it matches the task: 4K output, superior text rendering, advanced contextual editing.

You have access to RunAPI task tools for Flux Kontext.

Available Flux Kontext models:
- flux-kontext-max: 4K output, superior text rendering, advanced contextual editing
  endpoints: /api/v1/flux_kontext/text_to_image
  request fields: model, prompt
- flux-kontext-pro: Balanced speed and quality for in-context editing
  endpoints: /api/v1/flux_kontext/text_to_image
  request fields: model, prompt

Use the model ID and endpoint that match the user's request.
Example prompt: Edit this product photo: change the background to a tropical beach while keeping the product exactly the same.
/api/v1/flux_kontext/text_to_image: Submit the task, poll for its status, then verify the completed output. POST /api/v1/flux_kontext/text_to_image and save the returned Task id.
GET /api/v1/flux_kontext/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.

Public Versions and Endpoints

Model ID Endpoints Price Catalog
flux-kontext-max
/api/v1/flux_kontext/text_to_image
$0.17 / call Model detail
flux-kontext-pro
/api/v1/flux_kontext/text_to_image
$0.11 / 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 Kontext

  • Multi-round editing workflows

    Chain several edits in sequence, such as changing the lighting, swapping the background, and adding text, with each step building on the previous result.

  • Style conversion pipelines

    Convert photos to paintings, sketches, or anime style while preserving the subject composition, creating style variants of the same content.

  • Weather and lighting adjustments

    Change the time of day, weather, or lighting in existing photos without regenerating the entire scene.

Why Use Flux Kontext Through RunAPI + Hermes Agent

  • 2 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 Kontext Questions

Can I use Flux Kontext in Hermes Agent?

Yes. Configure RunAPI as a provider in Hermes Agent, then call the Flux Kontext endpoint shown on this page. The same RunAPI API key you use for chat handles image editing.

How does Hermes Agent run multi-step Flux Kontext edits?

Hermes Agent sends the source image and an editing instruction, then passes each output back as the input for the next edit, refining the image step by step.

How do I keep a character's identity while editing?

Pass the character image and describe only what should change. Flux Kontext keeps facial features and proportions by default, so no special tokens or reference IDs are needed.

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 Kontext 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