> ## Documentation Index
> Fetch the complete documentation index at: https://inference.docs.tensormesh.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# tm infer detokenize

> Call POST /detokenize on serverless inference.

## Usage

```sh theme={null}
tm infer detokenize [OPTIONS]
```

## Examples

### Detokenize token ids with the selected serverless model.

```sh theme={null}
tm infer detokenize --api-key YOUR_INFERENCE_API_KEY --model YOUR_SERVERLESS_MODEL_NAME --json '{"tokens":[15496,0]}'
```

## Options

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `--surface` | `choice[serverless]` | no | `"serverless"` | Inference surface to target. |
| `--model` | `text` | no | | Model name to use. Overrides `model` in the JSON request body. |
| `--api-key` | `text` | no | | Inference API key (Authorization: Bearer ...). |
| `--base-url` | `text` | no | | Override the base URL for the selected surface. |
| `--json` | `text` | no | | JSON request body or @file.json. When omitted, reads piped stdin if available. |
| `--file` | `path` | no | | Read JSON request body from file. |
| `--timeout` | `float` | no | | HTTP connect timeout in seconds for the inference request. |

## Inherited Global Options

| Name | Type | Required | Default | Details | | | | |
| - | - | - | - | - | - | - | - | - |
| `--version`, `-V` | `boolean` | no | `false` | Show the version and exit. Boolean flag. | | | | |
| `--config` | `path` | no | `"~/.config/tensormesh/config.toml"` | Path to config TOML file | | | | |
| `--output` | \`choice\[text | json | yaml | raw | table]\` | no | `"text"` | Output format (text is human-readable; json is machine-friendly). |
| `--quiet` | `boolean` | no | `false` | Suppress non-essential output. Boolean flag. | | | | |
| `--debug` | `boolean` | no | `false` | Print debug logs to stderr (secrets redacted). Boolean flag. | | | | |
| `--ca-bundle` | `path` | no | | Path to a PEM CA bundle for TLS verification (overrides TENSORMESH\_CA\_BUNDLE). | | | | |
| `--max-retries` | `integer` | no | | Max retries for idempotent HTTP requests on transient errors (overrides TENSORMESH\_MAX\_RETRIES; subcommands may override). | | | | |
| `--controlplane-base` | `text` | no | | Override the Control Plane base URL. | | | | |

## Auth Scope

* inference-api-key

## Caveats

* `--model` overrides the `model` field inside the JSON request body.

## Related Commands

* [`tm infer tokenize`](/cli/reference/infer/tokenize)
* [`tm infer models`](/cli/reference/infer/models)

## Parent Command

* [`tm infer`](/cli/reference/infer)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.