> For the complete documentation index, see [llms.txt](https://docs.mozilla.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mozilla.ai/any-guardrail/api-reference/index/content-safety/alinia.md).

# Alinia

Hosted content-moderation and safety-detection API with configurable detection policies.

Sends a text input or a full conversation to the Alinia API, which runs whichever detections you enable via `detection_config` (e.g. `{"security": True}` for prompt-injection / data-exfiltration detection, plus safety, compliance, and hallucination policies) and reports per-category verdicts. Alinia's detection models are multilingual (its security model is trained on English, Spanish, and Catalan).

Verdict mapping: `valid` is `True` when Alinia does not flag the input. `categories` flattens Alinia's nested `category_details` into one entry per `group/label` — boolean details become `triggered` flags, numeric details become per-category `score` values. The top-level `score` is the highest numeric category score (higher = riskier), or `None` when the endpoint returns only booleans. `explanation` carries the recommendation text when the endpoint returns one (e.g. sensitive information), `action` carries a structured recommendation's action (e.g. `"block"`), and `raw` is the full response JSON.

Expected inputs: `validate` accepts either a plain string or a list of chat-message dicts (`{"role": ..., "content": ...}`), plus an optional model `output` and optional `context_documents` for detections that evaluate responses in context.

You must obtain an API key and the endpoint URL from Alinia, and pass them either directly to the constructor or via the `ALINIA_API_KEY` / `ALINIA_ENDPOINT` environment variables.

For more information, see:

* [Alinia AI](https://alinia.ai/) (vendor site).
* [Integrating Alinia into any-guardrail](https://blog.mozilla.ai/integrating-alinia-into-any-guardrail-for-multilingual-ai-security/) (Mozilla AI blog walkthrough of this guardrail).

## Constructor

| Parameter          | Type              | Required         | Default | Description                                                       |
| ------------------ | ----------------- | ---------------- | ------- | ----------------------------------------------------------------- |
| `detection_config` | \`str             | dict\[str, float | bool]   | dict\[str, dict\[str, float                                       |
| `api_key`          | \`str             | None\`           | No      | `None`                                                            |
| `endpoint`         | \`str             | None\`           | No      | `None`                                                            |
| `metadata`         | \`dict\[str, Any] | None\`           | No      | `None`                                                            |
| `blocked_response` | \`dict\[str, str] | None\`           | No      | `None`                                                            |
| `stream`           | `bool`            | No               | `False` | Whether to request a streaming API response. Defaults to `False`. |

Initialize the Alinia guardrail with the provided configuration.

## validate

Validate conversation or text input using the Alinia API.

This can be used for validation using any of the API endpoints provided by Alinia.

**Parameters**

| Parameter           | Type         | Required                 | Default | Description |
| ------------------- | ------------ | ------------------------ | ------- | ----------- |
| `conversation`      | \`str        | list\[dict\[str, str]]\` | Yes     | —           |
| `output`            | \`str        | None\`                   | No      | `None`      |
| `context_documents` | \`list\[str] | None\`                   | No      | `None`      |

**Returns:** `GuardrailOutput`

## Benchmarks

No benchmark results recorded yet. See the [benchmark methodology](https://docs.mozilla.ai/any-guardrail/api-reference/benchmarks.md) for how numbers are harvested (published) or measured and added.

## License

* **Vendor:** Alinia AI
* **Default license:** `proprietary` (of the default model/service)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.mozilla.ai/any-guardrail/api-reference/index/content-safety/alinia.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
