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

# 요청 인증하기

> Developer Platform API 키, 권한, 만료, 안전한 관리 방법을 설명합니다.

## 개요

이 페이지에서는 Developer Platform 키의 인증, 권한, 만료, 보관 방법을 설명합니다. 키는 하나의 프로젝트에 고정되며 부여된 권한 안에서만 동작합니다.

## Developer Platform API 키 사용하기

모든 요청에 다음 Authorization 헤더를 보냅니다.

```http theme={null}
Authorization: Bearer nmp_...
```

일반 팀 설정에서 발급한 키는 워크스페이스, 해당 권한, NoimosAI 크레딧을 사용합니다. Developer Platform 키는 별도 프로젝트, 권한, 선불 USD 잔액을 사용합니다.

| 키 | 사용처 | 데이터 | 결제 |
| - | - | - | - |
| `nmp_` | Developer Platform API | 개발자 프로젝트, 실행 및 결과물 | 선불 USD 잔액 |
| 일반 NoimosAI API 키 | CLI, Local MCP, 일반 도구 API | NoimosAI 워크스페이스 | NoimosAI 크레딧 |

> [!WARNING]
>
> 두 종류의 키는 교환할 수 없습니다. 키가 유효하지 않거나 권한 또는 잔액이 부족해도 다른 인증이나 결제로 자동 전환되지 않습니다.

## 필수 권한 설정하기

키 생성 시 용도에 필요한 권한을 선택합니다.

| 권한 | 허용 작업 |
| - | - |
| `project:read` | 키가 속한 조직과 프로젝트 조회 |
| `usage:read` | 당월 확정 사용량과 USD 비용 조회 |
| `tools:read` | 도구 카탈로그 및 무료 견적 조회 |
| `tools:execute` | 입력 업로드, 유료 실행 및 취소 |
| `executions:read` | 실행 상태, 결과, 결과물 다운로드 URL 조회 |

연결 확인용 키와 유료 실행용 키를 나누면 실수로 실행되는 범위를 줄일 수 있습니다. 일반 유료 흐름에 필요한 프로젝트 조회, 견적, 실행, 결과 권한을 모두 점검하세요.

## 키를 만들 수 있는 역할

프로젝트의 `ADMIN` 또는 `DEVELOPER`가 키를 만듭니다. 조직 관리자도 해당 프로젝트에 명시적으로 참여해야 접근할 수 있습니다.

키에는 생성자와 프로젝트 권한이 적용됩니다. 생성자 계정이 비활성화되거나 프로젝트에서 제외되거나 키가 폐기되면 사용할 수 없습니다.

## 만료 관리하기

Developer Platform의 키 생성 화면에서 유효기간을 선택하고, 발급 후 키 목록에서 확인하세요. 전체 키는 한 번만 표시되므로 화면을 닫기 전에 안전하게 저장하세요.

만료 전에 새 키를 만들어 사용처를 전환한 뒤 기존 키를 폐기합니다. 유출이 의심되면 즉시 폐기하세요.

## 키를 안전하게 보관하기

키는 사용자 브라우저로 배포하지 않는 서버 측 비밀 정보로 취급합니다.

* 환경 변수나 비밀 정보 관리 서비스에 저장합니다.
* Git, 로그, 오류 화면, 분석 이벤트에 기록하지 않습니다.
* 브라우저나 모바일 앱에 직접 넣지 않습니다.
* 운영, 검증, 개발용 키와 프로젝트를 분리합니다.
* 용도별로 키를 나누고 최소 권한만 부여합니다.

## 인증 오류 해결하기

HTTP 상태와 키 상태를 차례로 확인합니다.

* `401` — Authorization 헤더, 전체 키, 만료, 폐기 여부를 확인합니다.
* `403` — 필수 권한과 소유자의 프로젝트 접근 권한을 확인합니다.
* `429` — 요청 한도, 선불 잔액, 조직 또는 프로젝트의 월간 한도를 확인합니다.

엔드포인트와 키의 조합이 불확실하면 유료 요청 전에 `GET /tools/project`로 프로젝트를 조회하세요.

## 관련 페이지

키 생성과 공통 사양은 다음 페이지에서 설명합니다.

* [시작하기](https://docs.noimosai.com/ko/developers/api/getting-started.md)
* [API 참조](https://docs.noimosai.com/ko/developers/api/reference.md)


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