---
title: "Embedding"
slug: "clovastudio-embedding"
updated: 2026-09-17T09:35:47Z
published: 2026-09-17T09:35:47Z
canonical: "api.ncloud-docs.com/clovastudio-embedding"
---

> ## 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.

# Embedding

Available in Classic and VPC

Perform vectorization tasks to represent text as numbers.

## Request

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

| Method | URI |
| --- | --- |
| POST | /v1/api-tools/embedding/{modelName} |

### 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 path parameters

You can use the following path parameters with your request:

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `modelName` | Enum | Required | Model for performing embedding - `clir-emb-dolphin` \| `clir-sts-dolphin` - `clir-emb-dolphin`: highly generalizable model that can be applied to any domain (default) - `clir-sts-dolphin`: model specialized for precisely measuring the meaning of sentences |

### Request body

The following describes the body.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `text` | String | Required | Text (tokens) to perform embedding - 1-500 |

### Request example

The request example is as follows:

```
curl --location --request POST 'https://clovastudio.stream.ntruss.com/v1/api-tools/embedding/{modelName}' \
--header 'Authorization: Bearer {API Key}' \
--header 'X-NCP-CLOVASTUDIO-REQUEST-ID: {Request ID}' \
--header 'Content-Type: application/json' \
--data '{
          "text": "How's the weather today?"
}'
```

## 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.embedding` | Array | - | Embedding performance results - Composed of a list of 1024 floats |
| `result.inputTokens` | Integer | - | Number of tokens in the text performing embedding |

### 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": {
      "embedding": [ -0.3861295, -0.7903874, ... , 0.2994273, -0.7736456, -0.24933687 ]
      "inputTokens": 4
    }
  }
```

#### 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)