feat(image_gen/fal): add Krea 2 Medium + Large to FAL catalog#33506
Merged
Conversation
fal announced Krea 2 day-0 as an official API partner on 2026-05-27.
Add both variants to the FAL_MODELS catalog so they appear in the
'hermes tools' model picker alongside flux-2, gpt-image, nano-banana,
etc. Users who already bill through FAL or Nous Portal subscription
can now use Krea without registering directly with Krea.
Model IDs (as listed in fal's launch announcement):
fal-ai/krea/v2/medium/text-to-image — $0.030 / image
fal-ai/krea/v2/large/text-to-image — $0.060 / image
Both share the same parameter schema:
- aspect_ratio (1:1, 4:3, 3:2, 16:9, 2.35:1, 4:5, 2:3, 9:16)
mapped from our 3 abstract ratios via size_style='aspect_ratio'
- creativity (raw|low|medium|high; default medium)
- seed (reproducibility)
- image_style_references (up to 10 per Krea's API spec)
No num_inference_steps / guidance_scale / num_images — Krea 2 does
not expose those, and the supports-set filter strips them defensively
if the agent ever passes them.
This is the FAL-routed variant. The separate native-Krea-API plugin
shipped in PR #33236 (plugins/image_gen/krea/) remains available for
users who want to bill directly through Krea's API with their own
key. Both routes converge on the same underlying model.
Nous Portal managed-FAL gateway: this commit makes the model IDs
known to the catalog and the picker. The Portal team will need to
allowlist these two endpoint slugs on the fal-queue origin server-side
for them to flow through the managed billing path.
Contributor
🔎 Lint report:
|
1 task
mathias3
pushed a commit
to mathias3/hermes-agent
that referenced
this pull request
May 28, 2026
…search#33506) fal announced Krea 2 day-0 as an official API partner on 2026-05-27. Add both variants to the FAL_MODELS catalog so they appear in the 'hermes tools' model picker alongside flux-2, gpt-image, nano-banana, etc. Users who already bill through FAL or Nous Portal subscription can now use Krea without registering directly with Krea. Model IDs (as listed in fal's launch announcement): fal-ai/krea/v2/medium/text-to-image — $0.030 / image fal-ai/krea/v2/large/text-to-image — $0.060 / image Both share the same parameter schema: - aspect_ratio (1:1, 4:3, 3:2, 16:9, 2.35:1, 4:5, 2:3, 9:16) mapped from our 3 abstract ratios via size_style='aspect_ratio' - creativity (raw|low|medium|high; default medium) - seed (reproducibility) - image_style_references (up to 10 per Krea's API spec) No num_inference_steps / guidance_scale / num_images — Krea 2 does not expose those, and the supports-set filter strips them defensively if the agent ever passes them. This is the FAL-routed variant. The separate native-Krea-API plugin shipped in PR NousResearch#33236 (plugins/image_gen/krea/) remains available for users who want to bill directly through Krea's API with their own key. Both routes converge on the same underlying model. Nous Portal managed-FAL gateway: this commit makes the model IDs known to the catalog and the picker. The Portal team will need to allowlist these two endpoint slugs on the fal-queue origin server-side for them to flow through the managed billing path.
Bryce-huang
pushed a commit
to wbkunlun/hermes-agent
that referenced
this pull request
May 29, 2026
…search#33506) fal announced Krea 2 day-0 as an official API partner on 2026-05-27. Add both variants to the FAL_MODELS catalog so they appear in the 'hermes tools' model picker alongside flux-2, gpt-image, nano-banana, etc. Users who already bill through FAL or Nous Portal subscription can now use Krea without registering directly with Krea. Model IDs (as listed in fal's launch announcement): fal-ai/krea/v2/medium/text-to-image — $0.030 / image fal-ai/krea/v2/large/text-to-image — $0.060 / image Both share the same parameter schema: - aspect_ratio (1:1, 4:3, 3:2, 16:9, 2.35:1, 4:5, 2:3, 9:16) mapped from our 3 abstract ratios via size_style='aspect_ratio' - creativity (raw|low|medium|high; default medium) - seed (reproducibility) - image_style_references (up to 10 per Krea's API spec) No num_inference_steps / guidance_scale / num_images — Krea 2 does not expose those, and the supports-set filter strips them defensively if the agent ever passes them. This is the FAL-routed variant. The separate native-Krea-API plugin shipped in PR NousResearch#33236 (plugins/image_gen/krea/) remains available for users who want to bill directly through Krea's API with their own key. Both routes converge on the same underlying model. Nous Portal managed-FAL gateway: this commit makes the model IDs known to the catalog and the picker. The Portal team will need to allowlist these two endpoint slugs on the fal-queue origin server-side for them to flow through the managed billing path. #AI commit#
zwolniony
pushed a commit
to zwolniony/hermes-agent
that referenced
this pull request
May 29, 2026
…search#33506) fal announced Krea 2 day-0 as an official API partner on 2026-05-27. Add both variants to the FAL_MODELS catalog so they appear in the 'hermes tools' model picker alongside flux-2, gpt-image, nano-banana, etc. Users who already bill through FAL or Nous Portal subscription can now use Krea without registering directly with Krea. Model IDs (as listed in fal's launch announcement): fal-ai/krea/v2/medium/text-to-image — $0.030 / image fal-ai/krea/v2/large/text-to-image — $0.060 / image Both share the same parameter schema: - aspect_ratio (1:1, 4:3, 3:2, 16:9, 2.35:1, 4:5, 2:3, 9:16) mapped from our 3 abstract ratios via size_style='aspect_ratio' - creativity (raw|low|medium|high; default medium) - seed (reproducibility) - image_style_references (up to 10 per Krea's API spec) No num_inference_steps / guidance_scale / num_images — Krea 2 does not expose those, and the supports-set filter strips them defensively if the agent ever passes them. This is the FAL-routed variant. The separate native-Krea-API plugin shipped in PR NousResearch#33236 (plugins/image_gen/krea/) remains available for users who want to bill directly through Krea's API with their own key. Both routes converge on the same underlying model. Nous Portal managed-FAL gateway: this commit makes the model IDs known to the catalog and the picker. The Portal team will need to allowlist these two endpoint slugs on the fal-queue origin server-side for them to flow through the managed billing path.
mosaiq-systems
pushed a commit
to mosaiq-systems/hermes-agent
that referenced
this pull request
May 29, 2026
…search#33506) fal announced Krea 2 day-0 as an official API partner on 2026-05-27. Add both variants to the FAL_MODELS catalog so they appear in the 'hermes tools' model picker alongside flux-2, gpt-image, nano-banana, etc. Users who already bill through FAL or Nous Portal subscription can now use Krea without registering directly with Krea. Model IDs (as listed in fal's launch announcement): fal-ai/krea/v2/medium/text-to-image — $0.030 / image fal-ai/krea/v2/large/text-to-image — $0.060 / image Both share the same parameter schema: - aspect_ratio (1:1, 4:3, 3:2, 16:9, 2.35:1, 4:5, 2:3, 9:16) mapped from our 3 abstract ratios via size_style='aspect_ratio' - creativity (raw|low|medium|high; default medium) - seed (reproducibility) - image_style_references (up to 10 per Krea's API spec) No num_inference_steps / guidance_scale / num_images — Krea 2 does not expose those, and the supports-set filter strips them defensively if the agent ever passes them. This is the FAL-routed variant. The separate native-Krea-API plugin shipped in PR NousResearch#33236 (plugins/image_gen/krea/) remains available for users who want to bill directly through Krea's API with their own key. Both routes converge on the same underlying model. Nous Portal managed-FAL gateway: this commit makes the model IDs known to the catalog and the picker. The Portal team will need to allowlist these two endpoint slugs on the fal-queue origin server-side for them to flow through the managed billing path.
KKT-OPT
pushed a commit
to KKT-OPT/hermes-agent
that referenced
this pull request
May 31, 2026
…search#33506) fal announced Krea 2 day-0 as an official API partner on 2026-05-27. Add both variants to the FAL_MODELS catalog so they appear in the 'hermes tools' model picker alongside flux-2, gpt-image, nano-banana, etc. Users who already bill through FAL or Nous Portal subscription can now use Krea without registering directly with Krea. Model IDs (as listed in fal's launch announcement): fal-ai/krea/v2/medium/text-to-image — $0.030 / image fal-ai/krea/v2/large/text-to-image — $0.060 / image Both share the same parameter schema: - aspect_ratio (1:1, 4:3, 3:2, 16:9, 2.35:1, 4:5, 2:3, 9:16) mapped from our 3 abstract ratios via size_style='aspect_ratio' - creativity (raw|low|medium|high; default medium) - seed (reproducibility) - image_style_references (up to 10 per Krea's API spec) No num_inference_steps / guidance_scale / num_images — Krea 2 does not expose those, and the supports-set filter strips them defensively if the agent ever passes them. This is the FAL-routed variant. The separate native-Krea-API plugin shipped in PR NousResearch#33236 (plugins/image_gen/krea/) remains available for users who want to bill directly through Krea's API with their own key. Both routes converge on the same underlying model. Nous Portal managed-FAL gateway: this commit makes the model IDs known to the catalog and the picker. The Portal team will need to allowlist these two endpoint slugs on the fal-queue origin server-side for them to flow through the managed billing path.
gweeteve
pushed a commit
to gweeteve/hermes-agent
that referenced
this pull request
Jun 2, 2026
…search#33506) fal announced Krea 2 day-0 as an official API partner on 2026-05-27. Add both variants to the FAL_MODELS catalog so they appear in the 'hermes tools' model picker alongside flux-2, gpt-image, nano-banana, etc. Users who already bill through FAL or Nous Portal subscription can now use Krea without registering directly with Krea. Model IDs (as listed in fal's launch announcement): fal-ai/krea/v2/medium/text-to-image — $0.030 / image fal-ai/krea/v2/large/text-to-image — $0.060 / image Both share the same parameter schema: - aspect_ratio (1:1, 4:3, 3:2, 16:9, 2.35:1, 4:5, 2:3, 9:16) mapped from our 3 abstract ratios via size_style='aspect_ratio' - creativity (raw|low|medium|high; default medium) - seed (reproducibility) - image_style_references (up to 10 per Krea's API spec) No num_inference_steps / guidance_scale / num_images — Krea 2 does not expose those, and the supports-set filter strips them defensively if the agent ever passes them. This is the FAL-routed variant. The separate native-Krea-API plugin shipped in PR NousResearch#33236 (plugins/image_gen/krea/) remains available for users who want to bill directly through Krea's API with their own key. Both routes converge on the same underlying model. Nous Portal managed-FAL gateway: this commit makes the model IDs known to the catalog and the picker. The Portal team will need to allowlist these two endpoint slugs on the fal-queue origin server-side for them to flow through the managed billing path.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds Krea 2 Medium + Krea 2 Large to the FAL_MODELS catalog. fal announced Krea 2 as a day-0 official API partner on 2026-05-27 — these model IDs are now selectable in
hermes tools→ Image Generation → FAL.ai alongside flux-2, gpt-image-2, nano-banana, etc.This is the FAL-routed variant. The native-Krea-API plugin shipped in PR #33236 (
plugins/image_gen/krea/) remains available for users who want to bill directly through Krea's API. Both converge on the same underlying model — pick the billing path you already have.Changes
tools/image_generation_tool.py— two newFAL_MODELSentries:fal-ai/krea/v2/medium/text-to-image($0.030/image)fal-ai/krea/v2/large/text-to-image($0.060/image)Both use
size_style: "aspect_ratio"(mapping landscape→16:9, square→1:1, portrait→9:16) andsupports = {prompt, aspect_ratio, creativity, seed, image_style_references}. Nonum_inference_steps/guidance_scale/num_images— Krea doesn't expose those, and the supports-set filter strips them defensively if the agent ever passes them.Parameter schema (per fal's API docs)
prompt(required)aspect_ratio—1:1, 4:3, 3:2, 16:9, 2.35:1, 4:5, 2:3, 9:16(Krea native; we map our 3 abstract ratios into this set)creativity—raw | low | medium | high(defaultmedium)seed— int (reproducibility)image_style_references— list of{image_url, strength}, max 10 per Krea's specNous Portal · managed-FAL gateway
This commit makes the IDs known to the catalog + picker. The Portal team will need to allowlist these two endpoint slugs on the
fal-queueorigin server-side for them to flow through the managed billing path. No code change needed on our end once that's done.Validation
tests/tools/test_image_generation.py(catalog invariants)tests/tools/test_image_generation_env.py_build_fal_payload()produces correct wire payload, supports-set filter strips unknown keysNot live-tested against fal yet — pending verifying the exact endpoint slug format (
fal-ai/krea/v2/...vskrea/v2/...; both forms appear in fal's launch materials).Refs: https://fal.ai/krea-2 · https://fal.ai/models/krea/v2/large/text-to-image/api · https://fal.ai/models/krea/v2/medium/text-to-image/api
Infographic