---
title: "Gradium integration for LuumenAI"
url: "https://www.luumen.ai/integrations/gradium/"
entity: SoftwareIntegration
category: "AI & automation"
audience: "SRE, DevOps, platform engineering, IT operations"
---

# Gradium integration for LuumenAI

Check voice usage and credits, and edit pronunciation dictionaries with approval.

## What LuumenAI can do with Gradium

LuumenAI connects to Gradium with an API token and exposes 9 tools (6 read-only · 2 write · 1 destructive). Reads answer immediately; writes are shown as a plan and require approval by default, configurable per tool by an administrator.

## Key facts

- Authentication: API token
- Tools available: 9 tools (6 read-only · 2 write · 1 destructive)
- Plan: available on all plans
- Category: AI & automation

## About Gradium with LuumenAI

Connect Gradium and your team can check credit balance, usage totals, and voice metadata without opening another console. Pronunciation dictionaries are readable rule by rule, so you can see exactly how a term is spoken today. Edits to those dictionaries are previewed and held for approval before they run. Luumen authenticates with an API key.

## Example tools

Read-only (6 in total):

- `GRADIUM_GET_CREDITS` — Get the connected Gradium subscription's current credit balance and billing-period metadata.
- `GRADIUM_GET_PRONUNCIATION_DICTIONARY` — Retrieve one pronunciation dictionary and its complete rewrite rule set by UID.
- `GRADIUM_GET_USAGE_SUMMARY` — Retrieve aggregate Gradium session, message, text, audio-duration, and consumed-credit usage totals.
- `GRADIUM_GET_VOICE` — Retrieve metadata for one Gradium catalog or custom voice by its UID.
- `GRADIUM_LIST_PRONUNCIATION_DICTIONARIES` — List pronunciation dictionaries for the connected organization, optionally filtered by language.
- `GRADIUM_LIST_VOICES` — List custom voices and, by default, Gradium's public voice catalog, returning voice IDs and metadata for later selection.

Write and destructive (3 in total, approval required by default):

- `GRADIUM_CREATE_PRONUNCIATION_DICTIONARY` — Create a language-specific pronunciation dictionary with optional rewrite rules.
- `GRADIUM_DELETE_PRONUNCIATION_DICTIONARY` — Permanently delete one pronunciation dictionary by UID.
- `GRADIUM_UPDATE_PRONUNCIATION_DICTIONARY` — Update pronunciation dictionary metadata and optionally replace its complete rewrite rule set.

## Frequently asked questions

### How does LuumenAI connect to Gradium?

Authorize once with API token. Luumen lists the scopes each action needs before you approve the connection, and credentials never appear in the chat.

### Can LuumenAI change things in Gradium on its own?

Read actions answer immediately. Anything that writes is shown as a plan and requires approval by default, including the 1 action classified as destructive. Administrators configure that per tool.

### Is there an audit trail?

Every call to Gradium — read or write, approved or declined — is recorded with the actor, the input, and the result.

Full page: https://www.luumen.ai/integrations/gradium/