roboflow/supervision · error · ValueError

Argument {arg} is not allowed for {vlm.name}

Error message

Argument {arg} is not allowed for {vlm.name}

What it means

Error "Argument {arg} is not allowed for {vlm.name}" thrown in roboflow/supervision.

Source

Thrown at src/supervision/detection/vlm.py:207

        except ValueError:
            raise ValueError(
                f"Invalid vlm value: {vlm}. Must be one of {[e.value for e in VLM]}"
            )

    if not isinstance(result, RESULT_TYPES[vlm]):
        raise ValueError(
            f"Invalid VLM result type: {type(result)}. Must be {RESULT_TYPES[vlm]}"
        )

    required_args = REQUIRED_ARGUMENTS.get(vlm, [])
    for arg in required_args:
        if arg not in kwargs:
            raise ValueError(f"Missing required argument: {arg}")

    allowed_args = ALLOWED_ARGUMENTS.get(vlm, [])
    for arg in kwargs:
        if arg not in allowed_args:
            raise ValueError(f"Argument {arg} is not allowed for {vlm.name}")

    return vlm


@deprecated(  # type: ignore[untyped-decorator]
    target=_validate_vlm_parameters,
    deprecated_in="0.29.0",
    remove_in="0.32.0",
)
def validate_vlm_parameters(vlm: VLM | str, result: Any, kwargs: dict[str, Any]) -> VLM:
    return void(vlm, result, kwargs)  # type: ignore[no-any-return]


def from_paligemma(
    result: str, resolution_wh: tuple[int, int], classes: list[str] | None = None
) -> tuple[npt.NDArray[Any], npt.NDArray[Any] | None, npt.NDArray[Any]]:
    """
    Parse bounding boxes from paligemma-formatted text, scale them to the specified

View on GitHub (pinned to 7f254d9784)

Solutions

1. Remove the named argument; it is not accepted for the selected VLM.
2. Consult the connector documentation for which keyword arguments are valid for each model.

When it happens

Trigger: Thrown at src/supervision/detection/vlm.py:207 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of roboflow/supervision@7f254d9784 (2026-08-15). Data as JSON: /api/errors/52dae63a5605eb5e. Report an issue: GitHub.