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

# Jan で Ace Data Cloud を使用する

> Platform API guide - Ace Data Cloud

[Jan](https://jan.ai/) はオフライン優先のオープンソース AI デスクトップクライアントであり、ローカルでモデルを実行することも、**Remote Engine** を通じて OpenAI 互換エンドポイントに接続することもできます。本記事では、Ace Data Cloud への接続方法を紹介します。

## 申請手順

Jan で Ace Data Cloud に接続するには、まず [Ace Data Cloud コンソール](https://platform.acedata.cloud/console/applications) にアクセスして、API Token を取得し、控えておいてください。

![Ace Data Cloud API Key を取得](https://cdn.acedata.cloud/dvc3cg.jpg)

まだログインまたは登録していない場合は、ログインページへ自動的にリダイレクトされ、登録とログインが案内されます。ログイン・登録後は現在のページに自動的に戻ります。

初回申請時には無料クレジットが付与され、Ace Data Cloud のモデルサービスを無料で体験できます。

## Jan をダウンロードする

[Jan 公式サイト](https://jan.ai/) からプラットフォーム別にダウンロードしてください（Windows、macOS、Linux）。Apple Silicon モデルでは、最適なパフォーマンスを得るために arm64 パッケージをダウンロードしてください。

## Ace Data Cloud を設定する

Jan ではモデルを **Local Engine**（ローカル実行）と **Remote Engine**（サードパーティ API）の2種類に分けています。Ace Data Cloud は OpenAI 互換プロトコルを使用するため、Remote Engine として接続します。

Jan を開き、**Settings → Model Providers** に移動して、**OpenAI** カードを見つけて編集します：

| フィールド | 値 | 説明 |
| - | - | - |
| API Key | あなたの Ace Data Cloud Token | コンソールからコピーした Token |
| Base URL | `https://api.acedata.cloud/v1` | **必ず `/v1` で終わる必要があり、末尾にスラッシュを付けないでください** |

> Base URL が `/v1` で終わる必要があることは、Jan 公式ドキュメントで明確に定められています。元の OpenAI 設定を上書きしたくない場合は、「+ Add Provider」で `openai-compatible` タイプの Provider を新規作成し、同じ内容を入力してください。

![Jan に AceDataCloud Provider を追加する設定画面](https://cdn.acedata.cloud/26017d28afa1.png)

カスタム Provider を保存すると、Jan はまず `{Base URL}/models` を呼び出してモデルリストの取得を試みます。現在のバージョンまたはエンドポイントが利用可能なリストを返さない場合は、同じ編集ページの下部で **+ Add Model** をクリックし、モデル ID を手動で入力してください。追加後、モデルは左上のドロップダウンに表示され、リモート / ローカルを区別するための「Cloud」アイコンが付きます。

![Jan Provider のモデル管理画面](https://cdn.acedata.cloud/ae485550946c.png)

> `MODEL_ID` はプレースホルダーです。[モデルカタログ](https://platform.acedata.cloud/models) にアクセスして確認し、対象モデル名に置き換えてください。厳密な検証時には、`/v1/models` レスポンス内の `id` 値を基準にしてください。この値が API の `model` パラメータで使用するモデル名であり、サービスまたは API の UUID ではありません。

## モデルを選択する

[モデルカタログ](https://platform.acedata.cloud/models) は継続的に更新されます。クライアントが自動的に読み込むモデルリストを優先して使用してください。手動入力が必要な場合は、まず `GET https://api.acedata.cloud/v1/models` をリクエストし、レスポンスの `data` 配列から対象モデルの `id` 値をコピーしてから、クライアントがサポートするコンテキスト、画像、ツール呼び出し機能に応じて選択してください。

## 接続を検証する

問題が Jan にあるのかネットワークにあるのか不明な場合は、先に curl を使用してエンドポイントを直接検証できます（`{token}` をあなたの Token に置き換えてください）：

```bash theme={null}
curl -X POST 'https://api.acedata.cloud/v1/chat/completions' \
  -H 'Authorization: Bearer {token}' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "MODEL_ID",
    "messages": [{"role": "user", "content": "ping"}]
  }'
```

OpenAI 互換の `chat.completion` オブジェクトが返されれば、Token とエンドポイントの両方が準備できていることを示します。`HTTP 403 used_up` が返された場合は、Token は有効ですが残高が不足していることを示すため、[コンソール](https://platform.acedata.cloud/console/applications) でチャージしてください。

## 上級編：ローカル + クラウドのハイブリッド

Jan には、有効化できるローカル OpenAI 互換 API Server（Settings → Local API Server）が組み込まれています。有効化すると `http://localhost:1337/v1/chat/completions` でリッスンし、ダウンロードしたローカルモデルを実行します。これにより、LangChain / LlamaIndex などのフレームワークで Base URL をローカルに指定して無料でデバッグし、複雑なタスクでは Ace Data Cloud のリモートモデルに切り替えることができます。モデルを切り替えても会話コンテキストは失われません。

## よくある質問

### Connection error または 404 が表示される

通常は Base URL に `/v1` が抜けています。`https://api.acedata.cloud/v1` に変更してください（必ず `/v1` で終わる必要があり、`.../openai/v1` と書かないでください）。

### 401 Unauthorized が表示される

API Key に貼り付けたものが Ace Data Cloud の Token であること（`Bearer` プレフィックスを含まず、余分な空白がないこと）、および所属アプリケーションの残高が十分であることを確認してください。

### リモートモデルがドロップダウンに表示されない

まずモデル更新ボタンをクリックして `/v1/models` をトリガーしてください。自動検出に失敗した場合は、手動で **+ Add Model** を使用し、カタログ内のモデル `id` 値をそのまま追加してください。

### 画像をアップロードしてモデルに分析させることはできますか

可能ですが、現在のモデルカタログから視覚入力を明確にサポートしているモデルを選択する必要があります。

## 詳細を見る

* [Jan 公式サイト](https://jan.ai/) ｜ [Jan GitHub](https://github.com/menloresearch/jan) ｜ [Jan ドキュメント](https://jan.ai/docs)
* [Jan にカスタム OpenAI 互換エンドポイントを接続する公式ドキュメント](https://jan.ai/docs/desktop/remote-models/custom-endpoint)
* [Jan ローカル API Server 公式ドキュメント](https://jan.ai/docs/desktop/api-server)
* [Ace Data Cloud OpenAI Chat Completions API ドキュメント](https://platform.acedata.cloud/documents/openai-chat-completions)
* [Ace Data Cloud サービス一覧](https://platform.acedata.cloud/documents)
* [Ace Data Cloud コンソール](https://platform.acedata.cloud/console)


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