---
slug: /amivoice-api/manual/issue-api-key-on-mypage
---

마이페이지에서는 API key를 발급할 수 있을 뿐만 아니라, 지금까지 마이페이지에서 발급된 API key의 확인 및 무효화도 가능합니다.

마이페이지에서 API key와 관련된 작업은 [マイページ TOP] 마이케이지 TOP을 아래로 스크롤한 [接続情報] 연결 정보 섹션에서 할 수 있습니다. [マイページ TOP]은 이 [링크](https://acp.amivoice.com/mypage/dashboard)에서 직접 접근할 수 있습니다. 마이페이지에 접근하려면 로그인이 필요합니다.

## API Key 발급 절차

1. [接続情報] 연결 정보 섹션의 "API キーの発行" API key 발급 버튼을 클릭합니다. 아래 그림과 같이 "API キーの発行" API key 발급창이 표시됩니다.
2. 표시된 창에서 유효 기간, 연결 원본 IP 주소, API key 발급 기능에 대해 필요에 따라 설정합니다. 자세한 내용은 [제한 및 기능 부여](/amivoice-api/manual/issue-api-key-on-mypage#additional-features)를 확인하십시오.
3. [発行] 발급 버튼을 클릭하면 [API キー] API key에, 발급된 API key가 표시됩니다. "API キーの発行" API key 발급 윈도우를 닫은 후에도 확인이 가능합니다.

![그림. API key 발급 윈도우](/img/amivoice-api/manual/api-key-mypage.png "그림. API key 발급 윈도우")

### 제한 및 기능 부여 {#additional-features}
#### 유효 기간 {#exp-date}
유효 기간은 날짜를 지정하는 방법과 발급으로부터의 기간을 지정하는 방법을 선택할 수 있습니다. 발급으로부터의 기간은 시간 단위 또는 일 단위로 지정 가능합니다. [無期限] 무기한을 선택하면 유효 기간이 없는 API key를 발급할 수 있습니다.

#### 연결 원본 IP 주소
발급된 API key를 사용할 수 있는 연결 원본 IP 주소의 제한하여 지정할 수 있습니다. 아무것도 기입하지 않으면 IP 주소 제한이 없는 API key가 됩니다.

IP 주소를 범위로 지정하고 싶은 경우, CIDR로 지정할 수 있습니다.
```
예: 203.0.113.0/24
```

IP 주소 또는 그 범위를 여러 개 지정하고 싶은 경우, 공백으로 구분합니다.
```
예: 203.0.113.0/24 198.51.100.0/24
```

#### API key 발급 기능
API key 발급 기능을 부여하고 싶은 경우, [API キー] API key 항목의 [発行可能] 발급 가능 체크박스에 체크를 해주십시오.

## 발급된 API Key 확인 {#check-api-key}
마이페이지에서 발급한 API key는 [接続情報] 연결 정보에 리스트로 표시됩니다. 표의 [API キー] API key 열의 각 API key의 [表示] 표시를 클릭하면, 해당 API key를 표시할 수 있습니다. 또한, [制限] 제한 열에서 유효 기간이나 IP 주소 제한 설정을 확인할 수 있습니다.

[無効化済み API キーを表示] 무효화된 API key 표시 토글 버튼을 ON으로 하면, 마이페이지에서 발급하여 [무효화](#disable-api-key)를 실시한 API key가 표시됩니다.

**Note**
- API key 발급 기능의 유무는 확인할 수 없습니다.
- API key 발급 API를 사용하여 발급된 API key는 목록에 표시되지 않습니다.
- 수동으로 무효화를 하지 않고, 설정한 유효 기간이 만료되어 무효가 된 API key는 [無効化済み API キーを表示] 무효화된 API key 표시를 ON으로 해도 표시되지 않습니다.

## API Key 무효화 절차 {#disable-api-key}
마이페이지에서 발급된 API key는 마이페이지에서 수동으로 무효화가 가능합니다.

1. [接続情報] 연결 정보에서 무효화하고 싶은 API key의 체크박스에 체크를 하고, [無効化] 무효화 버튼을 클릭합니다.
2. [API キーの無効化] API key 무효화 라는 확인 화면이 표시되므로, API key에 문제가 없는지 확인한 후 [無効化] 무효화 버튼을 클릭합니다.
3. 계정에 등록된 이메일 주소로 인증 코드가 전송됩니다. 이 코드를 마이페이지에 표시되는 [認証コードの確認] 인증 코드 확인 화면에 입력하고, [送信] 보내기 버튼을 클릭합니다.
4. API key 무효화가 완료되고, 계정에 등록된 이메일 주소로 API key 무효화를 알리는 이메일이 도착합니다.

**Caution**
- API key에는 무효화할 수 있는 개수의 상한이 있습니다. 하나의 계정에서 무효화할 수 있는 API key는 **누적 20개까지**입니다. 위 단계 2에서 표시되는 [API キーの無効化] API key 무효화 화면에서 현재까지 무효화된 API key의 개수가 표시됩니다.
- API key 무효화는 API key 유출이 의심되는 등 보안상의 위험이 있는 경우에 이용하십시오. 정기적으로 API key를 갱신하고 싶거나 일시적으로 이용을 정지하고 싶은 경우 등에 대해서는, 무효화가 아니라 [유효 기간](#exp-date) 설정을 활용하십시오.
- 2025/06/30의 마이페이지 개정 이전에 생성된 계정이 처음부터 가지고 있는 API key는 무효화할 수 없습니다. 무효화하려면 탈퇴 후 새로 계정을 만들어야 합니다.
- API key 발급 API를 사용하여 발급된 API key는 무효화할 수 없습니다.