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

# 인증

> 권한 범위가 지정된 자격 증명으로 API 요청과 MCP 클라이언트를 인증하세요.

# 인증

API 키를 `x-api-key` 헤더 또는 `Authorization: Bearer` 자격 증명으로 전달하세요. 원격 MCP 클라이언트는 OAuth를 통해 로그인할 수도 있습니다. OAuth 액세스 토큰은 MCP 리소스에만 유효합니다. REST 호출에는 API 키를 사용하세요.

## 권한 범위가 지정된 키 만들기

[연동](https://app.voicecheap.ai/page-api)을 열어 키를 만들고 권한을 선택한 다음, 필요하면 만료일을 지정하세요. 전체 키는 한 번만 표시됩니다. 보안 비밀 저장소에 보관하세요. 나중에 이름, 권한, 만료일을 변경하거나 키를 폐기할 수 있습니다.

## 권한

각 작업에 필요한 권한은 [작업 카탈로그](https://api-docs.voicecheap.ai/docs/ko/api-reference/actions.md)에 명시되어 있습니다. 하나의 작업에 여러 권한이 필요할 수 있습니다. 읽기 권한으로는 생성, 수정, 삭제를 할 수 없습니다. 명시적인 권한이 없는 기존 키는 이전의 프로젝트 및 전사 접근 권한만 유지합니다. 새 기능을 사용하려면 키를 수정하거나 교체하세요.

| 영역 | 읽기 | 쓰기 또는 삭제 |
| - | - | - |
| 계정 | `account:read` | — |
| 사용량 | `usage:read` | — |
| 설정 | `settings:read` | `settings:write` |
| 팀 | `team:read` | `team:write` |
| 프로젝트 | `projects:read` | `projects:write`, `projects:delete` |
| 번역 | — | `translations:write` |
| 전사 | `transcription:read` | `transcription:write` |
| 자막 | `subtitles:read` | `subtitles:write` |
| 텍스트 음성 변환 | `tts:read` | `tts:write` |
| 음성 | `voices:read` | `voices:write` |
| 이미지 | `images:read` | `images:write` |
| 썸네일 | `thumbnails:read` | `thumbnails:write` |
| 폴더 | `folders:read` | `folders:write` |
| 용어집 | `glossary:read` | `glossary:write` |
| Webhook | `webhooks:read` | `webhooks:write` |
| 게시 | `publishing:read` | `publishing:write` |

권한은 자격 증명의 접근 범위를 제한하며 구독, 팀 내 역할, 프로젝트 소유권, 사용 가능한 미디어 크레딧을 변경하지 않습니다. 팀 관리 변경은 계속해서 팀 소유자만 할 수 있습니다.

## 헤더 예시

이 검색 요청은 키에 허용된 작업만 나열합니다. API 키를 브라우저 코드나 공개 저장소에 넣지 마세요.

```bash theme={null}
curl "https://api.voicecheap.ai/v1/actions" \
  -H "x-api-key: vc_your-api-key"
```

```bash theme={null}
curl "https://api.voicecheap.ai/v1/actions" \
  -H "Authorization: Bearer vc_your-api-key"
```

## OAuth 연결

호환되는 어시스턴트에서는 [원격 MCP 연결](https://api-docs.voicecheap.ai/docs/ko/ai/model-context-protocol.md)을 사용하고 VoiceCheap에 로그인하세요. 동의 화면에서 권한을 검토하세요. 연동 페이지에서 API 키를 삭제하지 않고도 각 연결을 폐기할 수 있습니다.

## 기존 REST 엔드포인트

기존 업로드, 번역, 프로젝트, 전사 경로는 계속 API 키를 허용하며 이제 해당 권한을 적용합니다. 매개변수는 [API 참조](https://api-docs.voicecheap.ai/docs/ko/api-reference/introduction.md)에서, 사용 규칙은 [제한 사항](https://api-docs.voicecheap.ai/docs/ko/api-reference/limits.md)에서 확인하세요.


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