# API 키

내 AI 에이전트나 스크립트가 SimianX AI를 사용할 수 있도록 키를 만들고, 한 번 복사하고, 쓸 수 있는 한도를 정하고, 폐기합니다.

- 모든 플랜. 키 개수는 플랜에 따라 다릅니다.
- 키 생성은 무료입니다. 키가 실행하는 모든 것은 계정의 포인트를 사용합니다.

API 키를 사용하면 AI 에이전트나 스크립트가 비밀번호 없이 내 계정으로 SimianX AI를 사용할 수 있습니다. 이 페이지는 키 자체를 다룹니다.

## 키 만들기

1. 계정 메뉴를 열고 **내 계정** 항목을 선택한 뒤 **API 키** 탭을 여세요.
2. **키 만들기** 버튼을 선택하세요. **새 API 키** 양식이 열립니다.
3. 키가 어디에 쓰이는지 알 수 있도록 **이름** 값을 입력하세요.
4. **이 키로 할 수 있는 일** 아래에서 키로 할 수 있는 일을 선택하세요. 시장 데이터와 뉴스 읽기, 분석 실행, 오토파일럿 관리, 키 관리입니다. 처음 세 가지는 기본으로 선택되어 있습니다. 분석 실행 권한이 없으면 키는 데이터를 읽을 수 있지만 분석을 시작할 수는 없습니다.
5. 선택 사항: **일일 예산(포인트)**, **월 예산(포인트)** 또는 **단일 호출 상한(포인트)** 값을 설정하세요. 입력란이 비어 있으면 한도가 없다는 뜻입니다.
6. 선택 사항: **사용하는 에이전트**, **IP 허용 목록**(한 줄에 주소 하나), **만료** 항목을 채우세요.
7. **키 만들기** 버튼을 선택하세요.

![새 API 키 양식. 이름 입력란, 권한 선택 항목, 포인트 단위의 선택적 예산 입력란 세 개, 사용하는 에이전트 입력란, IP 허용 목록 상자, 만료 목록, 키 만들기 버튼이 있습니다.](https://fw.simianx.ai/help/ko/account-api-key-form.light.8cfaa4cf6e.webp)

*새 API 키 양식*

## 키 복사하기

**새 키** 창에 키 전체가 표시됩니다. **복사** 버튼을 선택해 키를 에이전트나 비밀번호 관리자에 저장한 뒤 **완료** 버튼을 선택하세요.

> **되돌릴 수 없음**
> 키 전체는 이때 한 번만 표시됩니다. SimianX AI는 해시만 저장하므로 다시 보여 줄 수 없습니다. 키를 잃어버리면 폐기하고 새 키를 만드세요.

![새 키 창. 네 줄이 있고 줄마다 복사 버튼이 있습니다. 키 전체, 에이전트용 환경 변수로 설정하는 줄, 에이전트가 스스로 설정하도록 지시하는 문장, 키를 테스트하는 명령어입니다. 맨 아래에 완료 버튼이 있습니다.](https://fw.simianx.ai/help/ko/account-api-key-token.light.733f4f0f00.webp)

*키는 한 번만 표시됩니다*

## 목록 읽기

각 키에는 이름, 앞부분 문자, 오늘과 이번 달에 사용한 포인트, 예산, 마지막 사용 시점이 표시됩니다.

- **사용량**: 최근 7일간의 요청과 포인트를 엔드포인트별로 보여 줍니다.
- **편집**: 이름, 권한, 예산, 에이전트, IP 허용 목록을 변경합니다. 변경 사항은 다음 요청부터 적용됩니다.
- **폐기**: 키를 중단합니다.

## 키 폐기하기

1. 키의 줄에서 **폐기** 버튼을 선택하세요.
2. **이 키를 폐기할까요?** 대화 상자에서 **폐기** 버튼을 선택하세요.

> **되돌릴 수 없음**
> 폐기한 키를 사용한 요청은 즉시 작동을 멈추며, 키는 복구할 수 없습니다. 그 키로 시작한 오토파일럿은 내 계정에서 계속 실행됩니다. 원하면 **자동 조종 장치** 페이지에서 중지하세요.

## 포인트

> **포인트 사용**
> 키는 웹사이트와 같은 요율로 계정의 포인트를 사용합니다. 에이전트 하나가 허용한 것보다 많이 쓰지 못하도록 키마다 예산을 설정하세요. [포인트 및 요율](https://www.simianx.ai/ko/points)을 참고하세요.

## 알아 두면 좋은 점

- 탭에 보유한 키 수와 플랜에서 허용하는 키 수가 표시됩니다. 한도에 도달하면 **키 만들기** 버튼이 비활성화됩니다. 키를 폐기하거나 [플랜을 변경](https://www.simianx.ai/ko/help/points-and-plans/change-plan.md)하세요.
- 에이전트가 스스로 키를 요청할 수도 있습니다. 에이전트가 링크를 주면 승인하거나 거절합니다. [내 AI 에이전트 연결하기](https://www.simianx.ai/ko/help/market-tools/connect-ai-agent.md)를 참고하세요.
- 키로는 웹사이트에 로그인할 수 없으며 구독이나 결제 정보를 변경할 수 없습니다.

---

웹 페이지: https://www.simianx.ai/ko/help/account/api-keys
챕터: [계정](https://www.simianx.ai/ko/help/account.md)
전체 매뉴얼: https://www.simianx.ai/ko/help/manual.md