Use Flux 2 in Hermes Agent.
Flux 2 by Black Forest Labs ships two quality tiers — Pro at 5 cents per image for fast generation, and Flex at 14 cents for higher fidelity. Both support text-to-image and multi-source remix at 1k or 2k resolution. Hermes Agent calls it through the custom:runapi provider — same key and base URL configured for chat.
Use RunAPI to generate an image with Flux 2 Pro through Hermes Agent.
Requirements:
- Use the custom:runapi provider already configured in Hermes Agent
- Call the RunAPI text_to_image endpoint at https://runapi.ai/v1/text_to_image
- Set model to "flux-2-pro-text-to-image"
- The RUNAPI_API_KEY environment variable provides authorization
- Optionally set output_resolution to "1k" or "2k" and aspect_ratio to control dimensions
- The response is async — poll the task status endpoint until the task completes, then retrieve the image URL
curl -X POST https://runapi.ai/v1/text_to_image \
-H "Authorization: Bearer $RUNAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "flux-2-pro-text-to-image",
"prompt": "a ceramic vase with dried flowers on a linen tablecloth, natural window light, 35mm film grain",
"aspect_ratio": "3:4",
"output_resolution": "2k"
}'
{
"task_id": "tsk_abc123",
"status": "pending",
"model": "flux-2-pro-text-to-image"
}
Use Flux 2 in Hermes Agent in three steps
Configure RunAPI
Set the RUNAPI_API_KEY environment variable. If you already added RunAPI as a custom:runapi provider in Hermes Agent for chat, the same key and base_url work for Flux 2 image generation — no extra configuration needed.
export RUNAPI_API_KEY=runapi_xxx
Call Flux 2
Send a POST request to the text_to_image endpoint with model set to flux-2-pro-text-to-image. Include a prompt, and optionally set aspect_ratio (1:1, 4:3, 16:9, etc.) and output_resolution (1k or 2k). For multi-source remixing, use the remix_image endpoint with source_image_urls instead.
text_to_image
Get the result
The endpoint returns a task ID. Poll the task status endpoint until the status changes to completed, then retrieve the generated image URL from the response. RunAPI SDKs and the CLI handle polling automatically.
task_id: tsk_abc123
Flux 2 API parameters
| Parameter | Type | Description |
|---|---|---|
model |
string |
Required. flux-2-pro-text-to-image, flux-2-flex-text-to-image, flux-2-pro-remix-image, or flux-2-flex-remix-image. |
prompt |
string |
Text description of the image to generate. |
aspect_ratio |
string |
Optional. Output aspect ratio: 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, or 2:3. Remix endpoints also accept auto. |
output_resolution |
string |
Optional. 1k (default) or 2k. Higher resolution costs more per image. |
source_image_urls |
array |
Required for remix_image. Array of source image URLs to blend or transform. |
callback_url |
string |
Optional. Webhook URL for async completion notification. |
What is Flux 2 on Hermes Agent?
Flux 2 by Black Forest Labs delivers photorealism that users say "actually passes" for real photography, with a hit rate on material fidelity that makes it a go-to for stock photo replacement. Hermes Agent calls Flux 2 through the RunAPI custom provider, giving you iteration at scale -- generate dozens of brand-consistent variants from the same prompt without manual fine-tuning.
Flux 2 use cases
Stock photography replacement
Replace paid stock photo subscriptions by generating photorealistic images on demand -- product shots, lifestyle scenes, architectural visualization -- at a fraction of the cost.
Character sheets for game developers
Generate consistent character reference sheets from multiple angles, with Flux 2's multi-reference conditioning keeping the character design stable across poses.
E-learning instructor avatars
Create consistent instructor avatars for online courses, maintaining the same face and style across hundreds of lesson thumbnails and slide illustrations.
Flux 2 + Hermes Agent questions
Pro is the faster, more affordable tier at 5 cents per 1k image. Flex produces higher-fidelity output at 14 cents per 1k image. Both share the same API parameters and support text_to_image and remix_image endpoints through the custom:runapi provider.
You do not need local hardware. Hermes Agent calls Flux 2 through the RunAPI API -- all GPU inference runs server-side. No VRAM requirements, no ComfyUI setup, no model downloads. The FP8 quantized local version needs 24GB+ VRAM, but the RunAPI endpoint removes that requirement entirely.
Yes. Each variant bills per image with resolution-based pricing. For example, Flux 2 Pro costs 5 cents at 1k and 7 cents at 2k. Flux 2 Flex costs 14 cents at 1k and 24 cents at 2k. Check the RunAPI pricing page for current rates.
No. The custom:runapi provider you configured for chat already works for Flux 2 and all other RunAPI models. The same RUNAPI_API_KEY, base_url, and provider name handle LLM, image, video, and music requests.
Flux Kontext specializes in text-guided editing with a single input image and character consistency. Flux 2 focuses on text-to-image generation and multi-source remixing with selectable Pro/Flex quality tiers and 1k/2k resolution options. Both are by Black Forest Labs and share the same RunAPI key and billing.
Set the model parameter to the Pro or Ultra slug in your request. Hermes Agent can dynamically select the tier based on task requirements — Pro for speed and cost, Ultra for maximum quality — through the same custom:runapi provider.
Yes. Hermes Agent can generate an image with Flux 2, refine it with Flux Kontext for targeted edits, and upscale with Topaz or Recraft — all within a single agent workflow through the custom:runapi provider.
Hermes Agent general setup
Not configured yet? Start with the RunAPI setup guide for Hermes Agent.
Hermes Agent setup guide →Try Flux 2 in Hermes Agent today.
Get a free RunAPI key, configure the custom:runapi provider, and start generating images with Flux 2 Pro or Flex.