---
title: "エンドポイント管理"
description: "*.arkor.app エンドポイントの作成と運用。ターゲット・認証モード・API キー・実行履歴の保存期間・ライフサイクル。"
---

エンドポイントは `https://<slug>.arkor.app` 形式の専用 URL で、OpenAI 互換の chat completions を配信します。各エンドポイントはプロジェクトに属し、プロジェクトの **Endpoints** タブから管理します。ワイヤプロトコルは [Chat Completions API](/ja/docs/cloud/chat-completions) リファレンスを参照してください。

## エンドポイントの作成

**Endpoints → New endpoint** で 4 つを指定します。

![エンドポイント作成フォーム](/images/cloud/endpoint-new-light.png "www.arkor.ai/oddphin-org/support-bot/endpoints/new")
![エンドポイント作成フォーム](/images/cloud/endpoint-new-dark.png "www.arkor.ai/oddphin-org/support-bot/endpoints/new")

### サブドメインスラッグ

スラッグがエンドポイントのサブドメインになります。ルールは次のとおりです。

- 2〜50 文字。小文字英字・数字・ハイフン。
- 先頭・末尾のハイフンは不可。
- Arkor 全体でグローバルに一意。使用済みスラッグは競合エラーになります。
- 予約語（`www`、`api`、`app`、`admin`、`dashboard`、`docs`、`status` など）は拒否されます。

### ターゲット

エンドポイントが配信する対象で、次の 4 択です。

- **ジョブの最終アダプタ**は、完了した学習ジョブが生成した LoRA アダプタを、そのジョブのベースモデルに載せて配信します。
- **特定のチェックポイント**は、学習ジョブの途中チェックポイントをステップ番号で選びます。
- **ベースモデルのみ**は、サポート対象のベースモデルをアダプタなしで配信します。
- **全公開モデル（マルチモデル）**は、Arkor カタログの公開モデルすべてを配信します。呼び出し側が OpenAI の `model` フィールドでリクエストごとに 1 つを選びます。省略時はデフォルトモデルが使われ、現在の id は `GET /v1/models` で一覧でき、新しく公開されたモデルは自動的にエンドポイントに現れます（トップページのワンクリックエンドポイントはこのターゲットです）。

作成時にターゲットが検証されます。ジョブは同じプロジェクトに属していること、アダプタのアーティファクトが実在すること、ベースモデルが推論用に登録されていることが必要です。

### 認証モード

- **Fixed API key**（推奨）では、呼び出し側が `Authorization: Bearer` または `x-api-key` でキーを提示します。
- **No auth (public)** では、URL を知っていれば誰でも呼び出せます。

### 実行履歴の保存期間

リクエストとレスポンスを[実行履歴](/ja/docs/cloud/runs)として記録するかを制御します。

- **Keep for N days**（デフォルトは 7）。Cloud の画面では 1〜365 日。
- **Unlimited** は削除するまで保持します。
- **Don't store** は新規リクエストを何も記録しません。切り替え前に保存された実行は元のライフサイクルのまま残ります（[実行履歴](/ja/docs/cloud/runs#保存期間)参照）。

## API キー

Fixed key モードのエンドポイントは、有効なキーを最大 20 個持てます。各キーにはラベル（80 文字まで、有効なキー内で一意）を付けます。

![URL・設定・API キー・実行履歴が表示されたエンドポイント詳細ページ](/images/cloud/endpoint-detail-light.png "www.arkor.ai/oddphin-org/support-bot/endpoints/oddphin-support")
![URL・設定・API キー・実行履歴が表示されたエンドポイント詳細ページ](/images/cloud/endpoint-detail-dark.png "www.arkor.ai/oddphin-org/support-bot/endpoints/oddphin-support")

- 平文キーの表示は作成時の**一度きり**。保存されるのはハッシュと表示用プレフィックスのみです。
- キーは個別に失効できます。失効はおよそ 30 秒以内に反映されます（エッジがデプロイメント状態を短時間キャッシュするため）。
- 一覧には各キーのラベルとプレフィックスが表示されます。

利用者ごとに別のキーを配ると、他のキーをローテーションせずに 1 つだけ失効できます。

## エンドポイントの編集

エンドポイント詳細ページから、いつでも次の操作ができます。

- **認証モード**・**保存期間**の変更。
- **無効化 / 有効化**。無効化したエンドポイントは配信を停止しますが、スラッグと設定は保持されます。

ターゲット自体を変更する操作は現在ダッシュボードにはありません。同じ URL を別のジョブ・チェックポイント・ベースモデルへ差し替えるには [SDK の deployments API](/ja/docs/framework/sdk/deployments) を使います。クライアントに気づかれることなく、その場で更新されます。

## エンドポイントの削除

削除するとエンドポイントはキー・保存済み実行履歴ごと削除されます。配信の停止はキー失効と同じくおよそ 30 秒以内に反映されます（エッジがデプロイメント状態を短時間キャッシュするため）。スラッグは通常すぐに再登録可能になります。保存済み実行履歴が大きく、バックグラウンドのスイーパーによる後片付けが必要な場合に限り、その完了までスラッグが予約されたままになります。

## 匿名エンドポイント

アカウントなしで作成されたエンドポイントは挙動が異なります。トップページのワンクリックエンドポイントは 7 日で失効し（[ワンクリックエンドポイント](/ja/docs/cloud/app-server)参照）、匿名アイデンティティが保持できるエンドポイント数には上限があります。アカウント所有のエンドポイントは失効しません。