---
title: "VisionAccelerationSettings"
canonical_url: "https://www.nutrient.io/api/python/settings/vision/advanced/vision-acceleration-settings/"
md_url: "https://www.nutrient.io/api/python/settings/vision/advanced/vision-acceleration-settings.md"
last_updated: "2026-07-15T14:46:57.766Z"
description: "Settings for VisionAcceleration. Values fall back through three levels: document → SDK → built-in default."
---

Settings for VisionAcceleration. Values fall back through three levels: document → SDK → built-in default. Writes target the document only when set on a document's settings, otherwise the SDK globally when set on SdkSettings.

**Tags:** `Vision`, `Advanced`

```python

from nutrient_sdk import VisionAccelerationSettings

```

## Construction

`VisionAccelerationSettings` is accessed through a [`Document`](/api/python/document/) instance for per-document overrides, or via [`SdkSettings`](/api/python/settings/document/sdk-settings/) for SDK-wide defaults.

```python

# Per-document override

with Document.open("input.pdf") as doc:
    settings = doc.settings.vision_acceleration_settings
    settings.some_field = new_value          # mutate fields directly

# SDK-wide default (applies to all documents)

SdkSettings.vision_acceleration_settings.some_field = new_value

```

Settings are configured by writing to fields on the returned object. The settings property itself cannot be reassigned — `doc.settings.vision_acceleration_settings = other_settings` is rejected.

## Properties

### gpu_excluded_modules

```python

@property
def gpu_excluded_modules(self) -> list

@gpu_excluded_modules.setter
def gpu_excluded_modules(self, value: list) -> None

```

Internal denylist of Vision capacity names that must run on the CPU even when `Provider` would otherwise put them on the GPU. Holds the models that don't (yet) work on the WebGPU execution provider; remove a name once its GPU path is fixed and validated. Hidden from the public settings schema. The values are capacity `Name`s (e.g. `"InferencePicture"`).

**Type:** `list`

**Default:** `Array.Empty<string>()`

---

### provider

```python

@property
def provider(self) -> ExecutionProvider

@provider.setter
def provider(self, value: ExecutionProvider) -> None

```

Execution provider for Vision ONNX model inference. Determines whether GPU-eligible models are offloaded to the GPU. Changing this at runtime (e.g. via the daemon) takes effect the next time a model session is (re)built.

**Type:** [`ExecutionProvider`](/api/python/enums/execution-provider/)

**Default:** `ExecutionProvider.Cpu`

---

---

## Related pages

- [Advanced](/api/python/settings/vision/advanced.md)
- [Per-document override](/api/python/settings/vision/advanced/ai-augmenter-settings.md)
- [Per-document override](/api/python/settings/vision/advanced/ai-processing-settings.md)
- [Per-document override](/api/python/settings/vision/advanced/claude-api-settings.md)
- [Per-document override](/api/python/settings/vision/advanced/content-extraction-settings.md)
- [Per-document override](/api/python/settings/vision/advanced/custom-vlm-api-settings.md)
- [Per-document override](/api/python/settings/vision/advanced/deskew-settings.md)
- [Per-document override](/api/python/settings/vision/advanced/document-layout-json-export-settings.md)
- [Per-document override](/api/python/settings/vision/advanced/finalizer-settings.md)
- [Per-document override](/api/python/settings/vision/advanced/form-labeling-settings.md)
- [Per-document override](/api/python/settings/vision/advanced/form-recognition-settings.md)
- [Per-document override](/api/python/settings/vision/advanced/google-api-settings.md)
- [Per-document override](/api/python/settings/vision/advanced/handwriting-settings.md)
- [Per-document override](/api/python/settings/vision/advanced/inference-layout-settings.md)
- [Per-document override](/api/python/settings/vision/advanced/ocr-settings.md)
- [Per-document override](/api/python/settings/vision/advanced/open-ai-api-endpoint-settings.md)
- [Per-document override](/api/python/settings/vision/advanced/open-ai-languages-detection-settings.md)
- [Per-document override](/api/python/settings/vision/advanced/open-ai-picture-alt-settings.md)
- [Per-document override](/api/python/settings/vision/advanced/reading-order-settings.md)
- [Per-document override](/api/python/settings/vision/advanced/segmenter-settings.md)
- [Per-document override](/api/python/settings/vision/advanced/table-recognition-settings.md)
- [Per-document override](/api/python/settings/vision/advanced/vision-descriptor-settings.md)
- [Per-document override](/api/python/settings/vision/advanced/words-detection-settings.md)