FLUX.1 Kontext Dev NIM for prompt-driven in-context image editing on a single GPU.
Configured minimum GPU memory.
After the last request a backend stays warm on its GPU for about 15 minutes, then frees the GPU. The next request triggers a fresh cold start.
POST to the native route with the shown model field; the playground below generates a full payload.
/v1/inference/black-forest-labs-flux-1-kontext-devPOSTblack-forest-labs-flux-1-kontext-devmodel_version: 1-1-3Terminal-ready smoke test for this selected target.
set -euo pipefail
# Forge API smoke test
# Forge selected target: route=/v1/models/black-forest-labs-flux-1-kontext-dev/inference-routes model=black-forest-labs-flux-1-kontext-dev version=1-1-3
FORGE_API_BASE=${FORGE_API_BASE:-'https://YOUR_FORGE_HOST'}
case "${FORGE_API_KEY:-}" in
""|replace-with-your-forge-api-key)
echo 'Set FORGE_API_KEY to a real Forge API key before running this snippet; browser SSO sessions are not sent to copied curl or SDK clients.' >&2
exit 1
;;
esac
forge_api_url() {
endpoint="$1"
base="${FORGE_API_BASE%/}"
case "$base:$endpoint" in
*/v1:/v1|*/v1:/v1/*|*/v1:/v1\?*) printf '%s%s\n' "$base" "${endpoint#/v1}" ;;
*) printf '%s%s\n' "$base" "$endpoint" ;;
esac
}
curl -sS --fail-with-body "$(forge_api_url '/v1/models/black-forest-labs-flux-1-kontext-dev/inference-routes?model_version=1-1-3')" \
--max-time "${FORGE_REQUEST_TIMEOUT_SECONDS:-600}" \
-H "Authorization: Bearer ${FORGE_API_KEY}" | \
python3 -m json.toolNative route check · Best for model-specific payloads; run the route check first, then copy the schema-specific request from the playground.
Copied snippets omit gpu_type and region, so Forge chooses a compatible GPU and region at request time. Use GPU performance to pin a target.
https://YOUR_FORGE_HOST/v1/inference/black-forest-labs-flux-1-kontext-devClient auth: Set FORGE_API_KEY to a real Forge API key before running copied curl, fetch, or SDK snippets. Browser SSO only authenticates this web session.
Open AccountAuthorization: Bearer $FORGE_API_KEYexport FORGE_API_BASE='https://YOUR_FORGE_HOST'
export FORGE_API_KEY="${FORGE_API_KEY:-replace-with-your-forge-api-key}"
export FORGE_REQUEST_TIMEOUT_SECONDS="${FORGE_REQUEST_TIMEOUT_SECONDS:-600}"
export FORGE_API_ROUTE='/v1/inference/black-forest-labs-flux-1-kontext-dev'
export MODEL_OR_FAMILY_SLUG='black-forest-labs-flux-1-kontext-dev'
export FORGE_MODEL_VERSION='1-1-3'Copy these values into a local .env file when moving the selected target into an app or SDK client.
# Forge selected target: route=/v1/inference/black-forest-labs-flux-1-kontext-dev model=black-forest-labs-flux-1-kontext-dev version=1-1-3
FORGE_API_BASE="https://YOUR_FORGE_HOST"
FORGE_API_ROUTE="/v1/inference/black-forest-labs-flux-1-kontext-dev"
FORGE_API_KEY="replace-with-your-forge-api-key"
FORGE_REQUEST_TIMEOUT_SECONDS="600"
MODEL_OR_FAMILY_SLUG="black-forest-labs-flux-1-kontext-dev"
FORGE_MODEL_VERSION="1-1-3"Add these rules before replacing the placeholder API key so local Forge secrets stay out of commits while .env.example can remain tracked.
# Forge local API secrets
.env
.env.*
!.env.examplehttps://YOUR_FORGE_HOST/v1/models/black-forest-labs-flux-1-kontext-dev/run-estimate?model_version=1-1-3set -euo pipefail
# Forge selected target: route=/v1/inference/black-forest-labs-flux-1-kontext-dev model=black-forest-labs-flux-1-kontext-dev version=1-1-3
FORGE_API_BASE=${FORGE_API_BASE:-'https://YOUR_FORGE_HOST'}
export MODEL_OR_FAMILY_SLUG=${MODEL_OR_FAMILY_SLUG:-'black-forest-labs-flux-1-kontext-dev'}
export FORGE_MODEL_VERSION=${FORGE_MODEL_VERSION:-'1-1-3'}
case "${FORGE_API_KEY:-}" in
""|replace-with-your-forge-api-key)
echo 'Set FORGE_API_KEY to a real Forge API key before running this snippet; browser SSO sessions are not sent to copied curl or SDK clients.' >&2
exit 1
;;
esac
forge_api_url() {
endpoint="$1"
base="${FORGE_API_BASE%/}"
case "$base:$endpoint" in
*/v1:/v1|*/v1:/v1/*|*/v1:/v1\?*) printf '%s%s\n' "$base" "${endpoint#/v1}" ;;
*) printf '%s%s\n' "$base" "$endpoint" ;;
esac
}
reliability_path="$(python3 -c 'import os
from urllib.parse import quote, urlencode
model = os.environ.get("MODEL_OR_FAMILY_SLUG", "").strip()
if not model:
raise SystemExit("Set MODEL_OR_FAMILY_SLUG from search or route finder output before checking reliability.")
params = {}
model_version = os.environ.get("FORGE_MODEL_VERSION", "").strip()
if model_version:
params["model_version"] = model_version
gpu_type = os.environ.get("FORGE_GPU_TYPE", "").strip()
if gpu_type:
params["gpu_type"] = gpu_type
region = os.environ.get("FORGE_REGION", "").strip()
if region:
params["region"] = region
path = "/v1/models/" + quote(model, safe="") + "/reliability"
if params:
path += "?" + urlencode(params)
print(path)')"
curl -sS --fail-with-body "$(forge_api_url "$reliability_path")" \
--max-time "${FORGE_REQUEST_TIMEOUT_SECONDS:-600}" \
-H "Authorization: Bearer ${FORGE_API_KEY}" | \
python3 -c 'import json, shlex, sys
payload = json.load(sys.stdin)
print(
f"{payload.get('\''slug'\'')} reliability={payload.get('\''reliability_status'\'')} "
f"supported={payload.get('\''supported_rows'\'', 0)}/{payload.get('\''total_rows'\'', 0)}"
)
filters = payload.get("filters") or {}
if filters:
print("filters: " + ", ".join(f"{key}={value}" for key, value in filters.items()))
def describe_target(target):
details = []
request_ms = target.get("request_ms_p50") or target.get("request_ms")
if request_ms is not None:
details.append(f"p50={request_ms}ms")
warm_cost = target.get("estimated_warm_request_cost_usd")
if warm_cost is not None:
details.append(f"warm_cost_usd={warm_cost}")
elif target.get("cost_per_gpu_hour_usd") is not None:
details.append(f"gpu_hour_usd={target['\''cost_per_gpu_hour_usd'\'']}")
success_rate = target.get("observed_success_rate")
if isinstance(success_rate, (int, float)):
details.append(f"success={success_rate:.0%}")
return ", ".join(details) or target.get("status") or "supported"
exports = {}
for label, key in (
("fastest supported", "fastest_supported_target"),
("lowest-cost supported", "lowest_cost_supported_target"),
):
target = payload.get(key) or {}
gpu_type = target.get("gpu_type")
if not gpu_type:
continue
identity = (str(gpu_type), str(target.get("region") or ""))
exports.setdefault(identity, {"labels": [], "target": target})["labels"].append(label)
if not exports:
print("No supported GPU/region target returned.", file=sys.stderr)
print(json.dumps({
"status_counts": payload.get("status_counts", {}),
"failure_reason_counts": payload.get("failure_reason_counts", {}),
}, indent=2))
raise SystemExit(1)
for (gpu_type, region), entry in exports.items():
assignments = [f"FORGE_GPU_TYPE={shlex.quote(gpu_type)}"]
if region:
assignments.append(f"FORGE_REGION={shlex.quote(region)}")
labels = " + ".join(entry["labels"])
details = describe_target(entry["target"])
print(f"export {'\'' '\''.join(assignments)} # {labels}: {details}")'https://YOUR_FORGE_HOST/v1/model-families/black-forest-labs-flux-1-kontext-dev/status?version=1-1-3set -euo pipefail
# Forge selected target: route=/v1/inference/black-forest-labs-flux-1-kontext-dev model=black-forest-labs-flux-1-kontext-dev version=1-1-3
FORGE_API_BASE=${FORGE_API_BASE:-'https://YOUR_FORGE_HOST'}
export MODEL_OR_FAMILY_SLUG=${MODEL_OR_FAMILY_SLUG:-'black-forest-labs-flux-1-kontext-dev'}
export FORGE_MODEL_VERSION=${FORGE_MODEL_VERSION:-'1-1-3'}
export FORGE_KEEP_WARM=${FORGE_KEEP_WARM:-false}
case "${FORGE_API_KEY:-}" in
""|replace-with-your-forge-api-key)
echo 'Set FORGE_API_KEY to a real Forge API key before running this snippet; browser SSO sessions are not sent to copied curl or SDK clients.' >&2
exit 1
;;
esac
forge_api_url() {
endpoint="$1"
base="${FORGE_API_BASE%/}"
case "$base:$endpoint" in
*/v1:/v1|*/v1:/v1/*|*/v1:/v1\?*) printf '%s%s\n' "$base" "${endpoint#/v1}" ;;
*) printf '%s%s\n' "$base" "$endpoint" ;;
esac
}
runtime_start_path="$(python3 -c 'import os
from urllib.parse import quote
model = os.environ.get("MODEL_OR_FAMILY_SLUG", "").strip()
if not model:
raise SystemExit("Set MODEL_OR_FAMILY_SLUG from the model picker output")
print("/v1/model-families/" + quote(model, safe="") + "/start")')"
python3 -c 'import json, os
def env_value(name):
value = os.environ.get(name, "").strip()
return value or None
payload = {}
version = env_value("FORGE_MODEL_VERSION")
if version:
payload["version"] = version
gpu_type = env_value("FORGE_GPU_TYPE")
if gpu_type:
payload["gpu_type"] = gpu_type
region = env_value("FORGE_REGION")
if region:
payload["region"] = region
keep_warm = env_value("FORGE_KEEP_WARM")
payload["run_until_stopped"] = (keep_warm or "").lower() in {"1", "true", "yes", "on"}
print(json.dumps(payload))' | \
curl -sS --fail-with-body "$(forge_api_url "$runtime_start_path")" \
--max-time "${FORGE_REQUEST_TIMEOUT_SECONDS:-600}" \
-X POST \
-H "Authorization: Bearer ${FORGE_API_KEY}" \
-H "Content-Type: application/json" \
-d @- | \
python3 -c 'import json, sys
payload = json.load(sys.stdin)
slug = payload.get("slug") or "runtime"
gpu_type = payload.get("gpu_type") or "scheduler-selected GPU"
region = payload.get("region") or "scheduler-selected region"
startup_ms = payload.get("startup_ms")
state = "cold-started" if payload.get("was_cold_start") else "already warm"
suffix = f"; startup_ms={startup_ms}" if startup_ms is not None else ""
print(f"{slug} {state} on {gpu_type} in {region}{suffix}; keep_warm={payload.get('\''keep_warm'\'')}")'Pick a verified target for repeatable runs. Failed or pending details appear on the status hover.
No verified targets yet
| GPU | Region | Status | Cold start | Model time | Est. $/GPU-hr |
|---|---|---|---|---|---|
| B200 | — | not probed | — | — | — |
| B300 | — | not probed | — | — | — |
| H100 | — | not probed | — | — | — |
| H200 | — | not probed | — | — | — |
| L40S | — | not probed | — | — | — |
| RTX6000 | — | not probed | — | — | — |
Model time uses the p50 warm model-reported execution time when available, then falls back to the latest probe time; p95/p99 and sample count appear when there is enough probe history. Cold start excludes the first (uncached) run. VRAM is the peak GPU memory seen during the probe. The fastest chip marks only verified supported GPU-region rows. Estimated on-demand GPU price (Nebius pay-as-you-go); shown for performance/price comparison. Configured minimum GPU memory: 16 GB.
/v1/inference/black-forest-labs-flux-1-kontext-devModelblack-forest-labs-flux-1-kontext-devVersion1-1-3GPUautomaticRegionautomaticSnippet target: black-forest-labs-flux-1-kontext-dev version 1-1-3 using scheduler-selected GPU/region.
Client auth: Set FORGE_API_KEY to a real Forge API key before running copied curl, fetch, or SDK snippets. Browser SSO only authenticates this web session.
Open AccountFORGE_API_BASE=${FORGE_API_BASE:-'https://YOUR_FORGE_HOST'}
case "${FORGE_API_KEY:-}" in
""|replace-with-your-forge-api-key)
echo 'Set FORGE_API_KEY to a real Forge API key before running this snippet; browser SSO sessions are not sent to copied curl or SDK clients.' >&2
exit 1
;;
esac
forge_api_url() {
endpoint="$1"
base="${FORGE_API_BASE%/}"
case "$base:$endpoint" in
*/v1:/v1|*/v1:/v1/*|*/v1:/v1\?*) printf '%s%s\n' "$base" "${endpoint#/v1}" ;;
*) printf '%s%s\n' "$base" "$endpoint" ;;
esac
}
forge_print_response() {
response_file="$1"
if [ ! -s "$response_file" ]; then
printf '%s\n' '(empty response)'
return 0
fi
if command -v python3 >/dev/null 2>&1; then
python3 -m json.tool "$response_file" 2>/dev/null || cat "$response_file"
else
cat "$response_file"
fi
}
response_file="$(mktemp)"
if curl -sS --fail-with-body "$(forge_api_url '/v1/inference/black-forest-labs-flux-1-kontext-dev')" \
--max-time "${FORGE_REQUEST_TIMEOUT_SECONDS:-600}" \
-H "Authorization: Bearer ${FORGE_API_KEY}" \
-H "Content-Type: application/json" \
-d '{
"seed": 0,
"image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mP8/x8AAwMCAO+/p9sAAAAASUVORK5CYII=",
"model": "black-forest-labs-flux-1-kontext-dev",
"steps": 30,
"prompt": "Transform the input image into a clean watercolor icon on a white background",
"model_version": "1-1-3"
}' \
-o "$response_file"; then
forge_print_response "$response_file"
status=$?
rm -f "$response_file"
(exit "$status")
else
status=$?
cat "$response_file" >&2
rm -f "$response_file"
(exit "$status")
fiCopy setup before the request when moving this snippet into a fresh shell. The default 600 second timeout is intentional for GPU cold starts and can be overridden with FORGE_REQUEST_TIMEOUT_SECONDS.
export FORGE_API_BASE='https://YOUR_FORGE_HOST'
export FORGE_API_KEY="${FORGE_API_KEY:-replace-with-your-forge-api-key}"
export FORGE_REQUEST_TIMEOUT_SECONDS="${FORGE_REQUEST_TIMEOUT_SECONDS:-600}"Copy these values into a local .env file when moving the selected target into an app or SDK client.
# Forge selected target: route=/v1/inference/black-forest-labs-flux-1-kontext-dev model=black-forest-labs-flux-1-kontext-dev version=1-1-3
FORGE_API_BASE="https://YOUR_FORGE_HOST"
FORGE_API_ROUTE="/v1/inference/black-forest-labs-flux-1-kontext-dev"
FORGE_API_KEY="replace-with-your-forge-api-key"
FORGE_REQUEST_TIMEOUT_SECONDS="600"
MODEL_OR_FAMILY_SLUG="black-forest-labs-flux-1-kontext-dev"
FORGE_MODEL_VERSION="1-1-3"Run a request to see output here.
Run a dedicated, autoscaling endpoint in your own Nebius account. The endpoint runs under your account and billing — Forge just pre-fills the configuration for you.
Opens the Nebius Console with the image pre-filled for FLUX.1 Kontext Dev (Forge version 1.1.3).
Prefer to create the endpoint from the CLI, or self-manage the container image? Use the commands below.
The image is hosted on cr.eu-north1.nebius.cloud; you may need registry credentials in the Console form. The CLI below includes placeholders.
The links use Forge’s eu-north1 Nebius Container Registry mirror. If your project can’t pull that private mirror, add pull credentials or a registry secret.
# Runs in YOUR Nebius account (you own + pay for the endpoint).
# platform/preset must exist in your project — list them with:
# nebius compute platform list
export ENDPOINT_NAME="black-forest-labs-flux-1-kontext-dev-private"
export AUTH_TOKEN=$(openssl rand -hex 32)
export SUBNET_ID=$(nebius vpc subnet list --format jsonpath='{.items[0].metadata.id}')
export REGISTRY_USERNAME="YOUR_REGISTRY_USERNAME"
export REGISTRY_PASSWORD="YOUR_REGISTRY_PASSWORD"
# Note: the --image above points at Forge's regional Nebius CR mirror.
# Serverless AI can pull Container Registry images without credentials
# only when the image is public or in the same project. For a private
# mirror in another project, provide pull credentials or a MysteryBox
# registry secret with REGISTRY_USERNAME and REGISTRY_PASSWORD.
nebius ai endpoint create \
--name "$ENDPOINT_NAME" \
--image "cr.eu-north1.nebius.cloud/e00h91c5sa606xfwpj/models/nim-black-forest-labs-flux.1-kontext-dev:1.1.3" \
--registry-username "$REGISTRY_USERNAME" \
--registry-password "$REGISTRY_PASSWORD" \
--container-port 8000 \
--auth token \
--token "$AUTH_TOKEN" \
--subnet-id "$SUBNET_ID"
export ENDPOINT_ID=$(nebius ai endpoint get-by-name --name "$ENDPOINT_NAME" --format jsonpath='{.metadata.id}')
nebius ai endpoint get "$ENDPOINT_ID"Need a throughput- and cost-optimized build tuned for specific Nebius GPUs? Nebius Token Factory is coming soon — contact your Nebius account team for early access.