---
title: "AiTEMS overview"
slug: "aitems-overview"
tags: ["AiTEMS", "API Gateway", "overview"]
updated: 2026-09-17T09:35:47Z
published: 2026-09-17T09:35:47Z
canonical: "api.ncloud-docs.com/aitems-overview"
---

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

# AiTEMS overview

Available in Classic and VPC

AiTEMS is a NAVER Cloud Platform service that enables you to easily and quickly implement and provide recommendation services tailored to the user's tastes without requiring expertise in machine learning (ML) and AI. The AiTEMS service provides the features to create and manage datasets and schemas for training in the form of RESTful APIs.

              Note

              

To use AiTEMS APIs, you need to subscribe to the AiTEMS service from the NAVER Cloud Platform console first. See [Subscribe to AiTEMS service](https://guide.ncloud-docs.com/beta/docs/en/aitems-start#%EC%9D%B4%EC%9A%A9%EC%8B%A0%EC%B2%AD).

## Common AiTEMS settings

The following describes commonly used request and response formats in AiTEMS APIs.

### Request

The following describes the common request format.

#### API URL

The request API URL is as follows:

```
https://aitems.apigw.ntruss.com/api/v1
```

#### Request headers

The following describes the headers.

| Field | Required | Description |
| --- | --- | --- |
| `x-ncp-apigw-timestamp` | Required | This is the number of milliseconds that have elapsed since January 1, 1970 00:00:00 UTC. - Request is considered invalid if the timestamp differs from the current time by more than 5 minutes. - Unix timestamp format. |
| `x-ncp-iam-access-key` | Required | Access key issued on NAVER Cloud Platform - Issue and check access key: See [Create authentication key](/docs/en/common-ncpapi). - Issue and check access key for sub account: See [Create sub account](https://guide.ncloud-docs.com/docs/en/subaccount-use#%EC%84%9C%EB%B8%8C-%EA%B3%84%EC%A0%95-%EC%83%9D%EC%84%B1). |
| `x-ncp-apigw-signature-v2` | Required | Base64-encoded signature that encrypts the request information with a secret key that maps to the access key issued on NAVER Cloud Platform, using the HMAC encryption algorithm (HmacSHA256) - Issue and check secret key: See [Create authentication key](/docs/en/common-ncpapi). - Create signature: See [Create signature](/docs/en/common-ncpapi). |
| `Content-type` | Required | Request data format`application/json` |

### Response

The following describes the common response format.

#### Response status codes

The following describes the response status codes.

| HTTP status code | Code | Message | Description |
| --- | --- | --- | --- |
| 201 | - | Created | Creation completed |
| 400 | - | Bad Request | Invalid request |
| 401 | - | Unauthorized | Authentication unavailable |
| 403 | - | Forbidden | Unauthorized |
| 404 | - | Not Found | Resource can't be found. |
| 500 | - | Internal Server Error | Server error |

              Note

              

For information about the HTTP status codes common to NAVER Cloud Platform, see [Ncloud API response status codes](/docs/en/common-ncpapi#3%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C).

## AiTEMS API

The following describes the APIs provided by the AiTEMS service.

### Service

The following describes the service-related APIs.

| API | Description |
| --- | --- |
| [Create service](/docs/en/ai-application-service-aitems-service-create) | Create new service. |
| [Edit service dataset](/docs/en/ai-application-service-aitems-service-updatedataset) | Set service dataset. |
| [Edit service update cycle](/docs/en/ai-application-service-aitems-service-updateinterval) | Set `interval` type service update cycle. |
| [Get service list](/docs/en/ai-application-service-aitems-service-list) | Get complete service list. |
| [Get service](/docs/en/ai-application-service-aitems-service-read) | Get service details. |
| [Request service learning](/docs/en/ai-application-service-aitems-service-learning) | Request one-time service training. |
| [Request service cycle training](/docs/en/ai-application-service-aitems-service-intervallearning) | Request cyclical service training. |
| [Modify service](/docs/en/ai-application-service-aitems-service-updatedesc) | Edit service information. |
| [Delete service](/docs/en/ai-application-service-aitems-service-delete) | Delete a service. |
| [Get training list](/docs/en/ai-application-service-aitems-service-trainlist) | Get complete training list. |
| [Get training](/docs/en/ai-application-service-aitems-service-trainread) | Get training details. |
| [Get update list](/docs/en/ai-application-service-aitems-service-updatelist) | Get service update list. |
| [Test training result](/docs/en/ai-application-service-aitems-service-infertest) | Test for checking training results. |
| [Upload cycle training data](/docs/en/ai-application-service-aitems-service-intervalupload) | Upload data to run cycle training. |

### Dataset

The following describes the dataset-related APIs.

| API | Description |
| --- | --- |
| [Create data sets](/docs/en/ai-application-service-aitems-dataset-create) | Create dataset for training the service. |
| [Get dataset list](/docs/en/ai-application-service-aitems-dataset-list) | Get complete dataset list. |
| [Get dataset](/docs/en/ai-application-service-aitems-dataset-read) | Get dataset details. |
| [Modify dataset](/docs/en/ai-application-service-aitems-dataset-modify) | Edit dataset information. |
| [Edit dataset description](/docs/en/ai-application-service-aitems-dataset-modifydesc) | Edit dataset description. |
| [Delete dataset](/docs/en/ai-application-service-aitems-dataset-delete) | Delete dataset. |

### Schema

The following describes the schema-related APIs.

| API | Description |
| --- | --- |
| [Create schema](/docs/en/ai-application-service-aitems-schema-create) | Create new schema. |
| [Get schema list](/docs/en/ai-application-service-aitems-schema-list) | Get complete schema list. |
| [Get schema](/docs/en/ai-application-service-aitems-schema-read) | Get schema details. |
| [Edit schema description](/docs/en/ai-application-service-aitems-schema-modifydesc) | Edit schema description. |
| [Delete schema](/docs/en/ai-application-service-aitems-schema-delete) | Delete schema. |
| [Check schema validity](/docs/en/ai-application-service-aitems-schema-validation) | Validate availability of schema information. |
| [Get basic schema information](/docs/en/ai-application-service-aitems-schema-default) | Get required basic schema information. |

## AiTEMS related resources

NAVER Cloud Platform provides a variety of related resources to help users better understand AiTEMS APIs.

- AiTEMS API guides
  - [Create signature](/docs/en/common-ncpapi#1-%EC%9D%B8%EC%A6%9D%ED%82%A4-%EC%83%9D%EC%84%B1): How to create a signature to add to the request header
  - [Common Ncloud response status codes](/docs/en/common-ncpapi#3-%EC%9D%91%EB%8B%B5-%EC%83%81%ED%83%9C-%EC%BD%94%EB%93%9C): Information on common response status codes of NAVER Cloud Platform used by the AiTEMS service
  - [API Gateway user guide](https://guide.ncloud-docs.com/docs/en/apigw-apigw-1): How to issue the API key to be added to the request header
  - [Sub Account User Guides](https://guide.ncloud-docs.com/docs/en/subaccount-overview): How to issue the access key to be added to the request header
  - [AiTEMS API guide](https://aitems.apigw.ntruss.com/apigw/swagger-ui?productId=uvbx2v4muw&apiId=jlm6fmocx2&stageId=ftvdxw778j&stageType=default): Check the AiTEMS API specification and perform simple tests
- How to use the AiTEMS service
  - [AiTEMS user guide](https://guide.ncloud-docs.com/docs/en/aitems-overview): How to use AiTEMS in the NAVER Cloud Platform console
  - [Ncloud user environment guide](https://guide.ncloud-docs.com/docs/en/environment-environment-1-1): Explore VPC and Classic environments and supported services.
  - [Pricing and features](https://www.ncloud.com/product/aiService/aitems): View pricing details and key capabilities.
  - [Official blog](https://blog.naver.com/n_cloudplatform/222881585655): Introduction of the AiTEMS service and implementation cases on the NAVER Cloud Platform official blog
  - [Latest service news](https://www.ncloud.com/intro/news): The latest news on AiTEMS
  - [FAQs](https://www.ncloud.com/support/faq/prod?categoryCode2=AI&categoryCode3=SV_0197): Get answers to common AiTEMS questions.
  - [Contact Support](https://www.ncloud.com/support/question/general): Get help if you can't find what you need in the user guide.\