63 lines
3.1 KiB
Markdown
63 lines
3.1 KiB
Markdown
# FLUX 3 Image
|
||
|
||
This directory contains the first controlled workflow and test plan for the
|
||
server's locally installed FLUX 3 Image Klein model. The workflow does not use
|
||
the remote `Flux3ImageNode` API.
|
||
|
||
## Workflow
|
||
|
||
- `workflow.json` — API-format prompt for `/prompt` automation.
|
||
- `prompt.txt` — fixed baseline prompt.
|
||
- `variables.json` — fixed values and allowed test variables.
|
||
- `results/` — output images and matching metadata records.
|
||
|
||
The local graph uses `flux3-image-klein-int8-convrot.safetensors`,
|
||
`qwen3vl_4b_int8_convrot.safetensors` with `type=flux3`, `flux2-vae.safetensors`,
|
||
Flux guidance, Euler sampling, and the native ComfyUI sampler chain. The
|
||
remote API node is not used because it requires a separate Comfy API login.
|
||
|
||
## Test matrix
|
||
|
||
The first pass changes one variable at a time. The prompt, aspect ratio,
|
||
grounding state, safety tolerance, and reference count remain fixed unless a
|
||
row explicitly changes them.
|
||
|
||
| ID | Purpose | Resolution | References | Grounding | Seed | Status | Runtime (s) | Verdict |
|
||
|---|---|---:|---:|---|---:|---|---:|---|
|
||
| F3I-T2I-01 | Shared-prompt local baseline | 1080×1920 target | 0 | Off | 310001 | **Passed** | 19.6 | 1088×1920 output generated |
|
||
| F3I-T2I-02 | Lower-cost output comparison | 0.75K | 0 | Off | 310002 | **Passed** | 1.6 | 768×768 output generated |
|
||
| F3I-T2I-03 | Detail/quality comparison | 1.5K | 0 | Off | 310003 | **Passed** | 5.6 | 1536×1536 output generated |
|
||
| F3I-T2I-04 | Higher-resolution feasibility | 2K | 0 | Off | 310004 | **Passed** | 14.0 | 2048×2048 output generated |
|
||
| F3I-T2I-05 | Grounded prompt comparison | 1K | 0 | On | 310005 | **N/A local** | — | Grounding belongs to remote API node |
|
||
| F3I-I2I-01 | Single-reference edit | 1K | 1 | Off | 310006 | **Passed** | 33.6 | 1024×1024 output generated |
|
||
|
||
## Evaluation
|
||
|
||
Record the exact prompt, seed, resolution, reference filename/hash, runtime,
|
||
output dimensions, success/failure, and visual notes in `results/<test-id>.json`.
|
||
Keep the first successful baseline as the comparison target. Do not promote a
|
||
larger resolution solely because it is larger; judge detail, composition,
|
||
prompt adherence, artifacts, and cost/runtime together.
|
||
|
||
The API node's seed controls rerun identity but the service may remain
|
||
nondeterministic. That is recorded as a property of the test, not treated as a
|
||
failure.
|
||
|
||
## Matrix results
|
||
|
||
The initial resolution and reference runs were calibration tests with a short
|
||
fox prompt. They remain useful for checking graph/model compatibility but are
|
||
superseded for model comparison by the shared prompt baseline. The native
|
||
reference conditioning path passed with `Base001.png`. The grounding row is not
|
||
run locally because grounding is a capability of the authenticated remote
|
||
`Flux3ImageNode`, which is intentionally excluded from this repository's
|
||
workflow.
|
||
|
||
## Initial run
|
||
|
||
The earlier API-node probe is retained as `results/F3I-T2I-01-remote-api.json`
|
||
as an environment diagnostic: it returned `Unauthorized` before generation.
|
||
The local workflow was then corrected to use the Flux 3-compatible
|
||
Qwen3-VL 4B encoder and 128-channel `flux2-vae.safetensors`; that run passed
|
||
and is recorded in `results/F3I-T2I-01.json`.
|