> ## 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/ja/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/ja/ai/model-context-protocol.md)を使用して VoiceCheap にサインインします。同意画面で権限を確認してください。連携ページから、API キーを削除せずに各接続を取り消せます。

## 既存の REST エンドポイント

既存のアップロード、翻訳、プロジェクト、文字起こしのルートでは引き続き API キーを使用でき、対応する権限が適用されます。パラメーターは [API リファレンス](https://api-docs.voicecheap.ai/docs/ja/api-reference/introduction.md)、利用ルールは[制限](https://api-docs.voicecheap.ai/docs/ja/api-reference/limits.md)を参照してください。


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