---
title: "Token calculator (Embedding v2)"
slug: "clovastudio-tokenizerembedding"
updated: 2026-09-17T09:35:47Z
published: 2026-09-17T09:35:47Z
canonical: "api.ncloud-docs.com/clovastudio-tokenizerembedding"
---

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

# Token calculator (Embedding v2)

Available in Classic and VPC

Calculate the number of tokens in a sentence entered in Embedding v2.

## Request

This section describes the request format. The method and URI are as follows:

| Method | URI |
| --- | --- |
| POST | /v1/api-tools/embedding/v2/tokenize |

### Request headers

For information about the headers common to all CLOVA Studio APIs, see [CLOVA Studio request headers](/docs/en/ai-naver-clovastudio-summary#%EC%9A%94%EC%B2%AD%ED%97%A4%EB%8D%94).

### Request body

You can include the following data in the body of your request:

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `text` | String | Required | List of conversation messages to count tokens for - 1-10,000 characters (based on Korean) |

### Request example

The request example is as follows:

```
curl --location --request POST 'https://clovastudio.stream.ntruss.com/v1/api-tools/embedding/v2/tokenize' \
--header 'Authorization: Bearer {API Key}' \
--header 'X-NCP-CLOVASTUDIO-REQUEST-ID: {Request ID}' \
--header 'Content-Type: application/json' \
--data '{
    "text": "Tell me the total number of tokens."
}'
```

## Response

This section describes the response format.

### Response body

The response body includes the following data:

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `status` | Object | - | See [Response status](/docs/en/ai-naver-clovastudio-summary#%EC%9D%91%EB%8B%B5). |
| `result` | Object | - | Response result |
| `result.numTokens` | Integer | - | Result of calculating the number of tokens |

### Response example

The response example is as follows:

#### Succeeded

The following is a sample response upon a successful call.

```
{
    "status": {
        "code": "20000",
        "message": "OK"
    },
    "result": {
        "numTokens": 1000
    }
}
```

#### Failure

The following is a sample response upon a failed call.

- [Common client error troubleshooting (4xx)](/docs/en/clovastudio-troubleshoot-c4xx)
- [Common server error troubleshooting (5xx)](/docs/en/clovastudio-troubleshoot-c5xx)