> For the complete documentation index, see [llms.txt](https://docs.wrks.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.wrks.ai/admin-help/integrations/api-keys.md).

# API 키 관리 화면의 모든 것

`기업관리자 > API 키 관리` 에서 회사 시스템이 웍스AI를 부를 때 쓰는 키를 발급합니다.

## API 키가 뭔가요

**사람이 아니라 시스템이 웍스AI를 쓸 때 필요한 열쇠예요.** 사내 프로그램에서 자동으로 문서를 요약하거나 번역하게 할 때 씁니다.

직원이 화면에서 쓰는 것과는 별개예요. 일반 사용에는 필요 없습니다.

## 화면에 있는 것

| 항목               | 무엇을 하나                                   |
| ---------------- | ---------------------------------------- |
| 새 API 키 발급       | 키 만들기                                    |
| 이름               | 어디에 쓰는 키인지 (예: production-system-key)    |
| 만료 기간            | `30일` / `90일` / `1년` / 직접 지정 (기본값은 `1년`) |
| 생성일 / 만료일        | 언제 만들고 언제 끝나는지                           |
| 곧 만료 / D-일       | 만료가 가까우면 표시                              |
| API Key 허용 IP 관리 | 이 키를 쓸 수 있는 IP 제한                        |

## 발급할 때 주의할 것

**발급 직후 화면에서만 키를 볼 수 있어요.** 창을 닫으면 다시 볼 수 없습니다. 꼭 복사해서 안전한 곳에 보관해 주세요.

이름은 나중에 알아볼 수 있게 지으세요. 키가 여러 개면 어떤 시스템 것인지 구분이 안 됩니다.

## 만료 기간

30일 / 90일 / 365일 중에 고르거나 직접 날짜를 정합니다.

**짧게 잡는 게 안전합니다.** 키가 유출돼도 자동으로 못 쓰게 되니까요. 다만 만료되면 그 키를 쓰는 시스템이 멈추니 미리 새 키로 바꿔주셔야 해요.

목록에서 만료가 가까운 키는 `곧 만료` 로 표시됩니다.

## 허용 IP 제한

이 키를 어느 IP에서만 쓸 수 있는지 정합니다. 키가 유출돼도 등록한 IP 밖에서는 못 씁니다.

**공인 IP만 등록할 수 있어요.** 세 가지 형식을 지원합니다.

| 형식    | 예시                              |
| ----- | ------------------------------- |
| 단일 IP | `218.144.97.227`                |
| 범위    | `218.144.97.227-218.144.97.230` |
| CIDR  | `218.144.97.224/29`             |

여러 개는 **콤마(,)로 구분**해서 넣습니다.

> 이 기능은 **회사당 하루 3,000원**(30일 기준 약 9만원)의 부가서비스예요.

***

## 자주 묻는 질문

### Q. 키를 잃어버렸어요. 다시 볼 수 있나요?

없습니다. 발급 직후에만 보여요. 새로 발급받고 예전 키는 삭제해 주세요.

### Q. 키를 삭제하면 어떻게 되나요?

그 키를 쓰는 시스템이 바로 멈춥니다. 삭제 전에 새 키로 바꿔두세요.

### Q. API 키로 쓴 사용량은 어디에 나오나요?

`기업관리자 > 이용 현황` 의 사용자 목록에서 **부가서비스/API** 로 모여 보입니다. → [사용자 목록에 있는 '부가서비스/API'는 무엇인가요](/admin-help/billing/addon-api-usage.md)

### Q. 키마다 사용량을 따로 볼 수 있나요?

지금은 하나로 합쳐서 보입니다.

### Q. 만료된 키는 어떻게 하나요?

새로 발급받아 시스템에 넣고, 예전 키는 삭제해 주세요.

### Q. "잘못된 IP 형식이 포함되어 있습니다" 라고 나와요.

사설 IP(`192.168.` 로 시작하는 것 등)는 등록할 수 없어요. 회사 공인 IP를 전산 담당자에게 확인해 주세요.

### Q. 우리 회사 공인 IP를 모르겠어요.

전산 담당자에게 문의해 주세요. 웍스AI에서는 알려드릴 수 없습니다.

### Q. 직원 로그인 IP 제한과 같은 건가요?

다릅니다.

* **API 키 허용 IP** — 시스템이 키로 부를 때
* **내부 통제의 IP 주소 관리** — 직원이 로그인할 때

→ [내부 통제 화면의 모든 설정](/admin-help/security/internal-control.md)

### Q. 키를 몇 개까지 만들 수 있나요?

시스템마다 따로 만드시는 걸 권합니다. 문제가 생겼을 때 그 키만 지우면 되니까요.

### Q. API 사용법 문서가 있나요?

연동 방식은 담당자가 안내해 드려요. 고객지원으로 문의해 주세요.

## 이럴 땐 문의해 주세요

* API 연동 방법을 알고 싶을 때
* 키가 유출된 것 같을 때 (바로 삭제 후 문의)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.wrks.ai/admin-help/integrations/api-keys.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.