> ## Documentation Index
> Fetch the complete documentation index at: https://studio-docs.thezet.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 인증

> API 키를 보내는 방법과 관리 방법이에요.

## 키 보내기

아래 둘 중 **하나만** 보내요. 둘 다 보내면 `401`이에요.

```bash theme={null}
Authorization: Bearer zet_live_...
```

```bash theme={null}
x-api-key: zet_live_...
```

`GET /health`, `GET /models`, `GET /models/{id}`, `POST /estimate`는 키 없이 호출할 수 있어요.

## 키 확인하기

`GET /me`로 키가 동작하는지 확인할 수 있어요. 응답에는 키 정보와 동시 실행 한도가 있어요.

```bash theme={null}
curl https://api.studio.thezet.io/v1/me -H "Authorization: Bearer $ZET_API_KEY"
```

## 키 관리

[API 키 화면](https://studio.thezet.io/settings/api-keys)에서 만들고 폐기해요.

* 키는 만들 때 한 번만 보여요. 저희도 해시만 저장해서 다시 알려드릴 수 없어요.
* 만들 때 만료일을 정할 수 있어요.
* 활성 키는 계정당 20개까지예요.
* 폐기하면 바로 효력이 없어져요. 다음 요청부터 `401`이에요.
* 작업과 잔액은 키가 아니라 계정에 속해요. 키를 바꿔도 이전 작업을 조회할 수 있어요.

## 지켜 주세요

> [!WARNING]
>
> 키는 서버에서만 쓰세요. 브라우저와 모바일 앱에서는 호출할 수 없도록 CORS를 열지 않았어요. 키가 새어 나갔다면 바로 폐기하고 새로 만들어 주세요. 키로 생긴 요금은 고객사가 부담해요.

## 인증 오류

| 상태 | 코드 | 뜻 |
| - | - | - |
| `401` | `unauthorized` | 키가 없거나, 잘못됐거나, 폐기·만료됐거나, 두 방식으로 함께 보냈어요. |
| `403` | `api_not_enabled` | 이 계정의 API 사용이 승인되지 않았어요. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.