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

# API 設定

> SoloEnt で AI モデルの API Key を設定する

API Key を設定して、SoloEnt の AI 執筆機能を有効にします。

## 設定の入り口

### 対話からすばやく設定

<Steps>
  <Step title="対話ウィンドウ下部のモデル名をクリック">
    Agent の対話下部にあるモデル名をクリックすると、モデル設定ページが開きます。
  </Step>
</Steps>

<img src="https://mintcdn.com/soloent/4RpSHkUFmW5kEqcF/assets/images/apikey_1.png?fit=max&auto=format&n=4RpSHkUFmW5kEqcF&q=85&s=a380930952d0ba22b51d93be0f9a74f3" alt="対話からすばやく API を設定" style={{ width: '70%', maxWidth: '400px', display: 'block' }} width="686" height="272" data-path="assets/images/apikey_1.png" />

### 設定パネルから

<Steps>
  <Step title="Agent 設定を開く">
    Agent パネルの設定アイコンをクリックします。
  </Step>

  <Step title="モデル設定に入る">
    公式モデルを直接使うか、自前のモデル（BYOK）を設定するかを選べます。
  </Step>
</Steps>

<img src="https://mintcdn.com/soloent/4RpSHkUFmW5kEqcF/assets/images/apikey_3.png?fit=max&auto=format&n=4RpSHkUFmW5kEqcF&q=85&s=261ac83f5e7036db95d25d509c2cc432" alt="設定パネルから API を設定" style={{ width: '70%', maxWidth: '400px', display: 'block' }} width="812" height="1072" data-path="assets/images/apikey_3.png" />

## 公式 API

SoloEnt は公式 API を提供しており、アカウントにログインすればそのまま使えます。第三者の Key を自分で申請する必要はありません。

### 無料モデル

公式が無料モデルを提供しており、ログインすればそのまま使えます。利用可能な無料モデルと割引は、運営イベントに合わせて継続的に更新されます。

<Note>
  登録ユーザーには全員 **\$0.5** の試用額度が付与されます。[プラットフォームのイベント](https://soloent.ai/ja/activities)に参加すると、さらに無料額度を獲得できます。
</Note>

<img src="https://mintcdn.com/soloent/4RpSHkUFmW5kEqcF/assets/images/apikey_4.png?fit=max&auto=format&n=4RpSHkUFmW5kEqcF&q=85&s=da746ca341868270d88d79da60e4fd00" alt="設定パネルで SoloEnt AI を API プロバイダーとして表示し、Free タブに利用可能な無料モデルを一覧表示" style={{ width: '70%' }} width="720" height="948" data-path="assets/images/apikey_4.png" />

<Warning>
  無料モデルはツールを試すためのものであり、利用者が多いなどの理由で応答が遅くなったり不安定になったりする場合があります。
</Warning>

### サブスクリプションユーザーのモデル（VIP）

Lite、Pro、Max の 3 段階のサブスクリプションユーザーは、Anthropic、OpenAI、Google、DeepSeek など主要プロバイダーの最新モデルを含む VIP リストのすべてのモデルを、第三者の API Key を設定せずに直接利用できます。

<Note>
  SoloEnt の API 料金は各モデル企業の公式料金と同一で、追加手数料はありません。またモデルごとに不定期でさまざまな割引が提供されます。
</Note>

すべての公式モデルと最新の割引情報は [soloent.ai/en/models](https://soloent.ai/en/models) で確認できます。

***

## 第三者の API Key を設定する

API Key は AI モデルにアクセスするための認証情報で、通常はランダムな文字列です：

```
sk-abc123xyz456def789ghi012jkl345mno678pqr901stu234
```

<Warning>
  **重要**：API の利用は月額サブスクリプションとは別に課金されます。\$20 のサブスクリプションに API 利用料は含まれません。たとえば、あなたが加入している Gemini の会員をここで API として使うことはできません。
</Warning>

### API Key の入手先

#### 人気のプロバイダー

| プロバイダー          | 最新モデル                              | 主な用途                          |
| --------------- | ---------------------------------- | ----------------------------- |
| **OpenAI**      | GPT-5.6                            | 執筆リサーチ、汎用執筆                   |
| **Anthropic**   | Claude Sonnet-5 / Opus-5 / Fable-5 | ストーリー設計、戦略的思考、本文執筆            |
| **Google**      | Gemini-3.1-pro                     | 高速、コスト効率、散文執筆、マルチモーダル         |
| **xAI**         | Grok-4.5                           | リアルタイム情報、柔軟なコンテンツポリシー、マルチモーダル |
| **DeepSeek**    | DeepSeek-V4-pro                    | 低コスト、柔軟なコンテンツポリシー             |
| **Zhipu AI**    | GLM-5.2                            | ストーリー設計、中国語コンテンツ              |
| **Moonshot AI** | Kimi-K3                            | 長いコンテキスト、中国語コンテンツ             |
| **OpenRouter**  | 複数のモデル                             | 統一アクセス、モデル比較                  |

<Tip>
  詳しいプロバイダー情報と登録手順は [完全な API ディレクトリ](../resources/api-directory) をご覧ください。
</Tip>

<Card title="無料 API Key を入手" icon="gift" href="../resources/free-api-keys">
  無料枠のオプションとコミュニティリソースを探す
</Card>

### 購入した API 情報を正しく入力する

#### 標準設定（公式プロバイダー）

OpenAI、Anthropic、Google および一部のアグリゲーター向け。API Provider のドロップダウンリストで対応するモデルプロバイダーを見つけ、API Key だけを入力します：

```plaintext theme={null}
API Key: sk-abc123xyz456...
```

#### OpenAI 互換設定（第三者）

API Provider のドロップダウンリストで **OpenAI Compatible** を選ぶと、第三者プロバイダーを設定できます。

<img src="https://mintcdn.com/soloent/4RpSHkUFmW5kEqcF/assets/images/zh/faq_api_openai.png?fit=max&auto=format&n=4RpSHkUFmW5kEqcF&q=85&s=eb6732c3e8b473cb83128b64173916ce" alt="API Configuration パネルで API Provider のドロップダウンを展開し、OpenAI Compatible オプションを赤枠で強調" style={{ width: '70%' }} width="934" height="992" data-path="assets/images/zh/faq_api_openai.png" />

ほとんどの第三者プロバイダーでは、3 つのフィールドすべての入力が必要です：

<ParamField path="base_url" type="string" required>
  API エンドポイント URL（例：`https://api.provider.com/v1`）
</ParamField>

<ParamField path="api_key" type="string" required>
  あなたの API Key
</ParamField>

<ParamField path="model_id" type="string" required>
  モデル識別子（例：`gpt-4-turbo`）
</ParamField>

<Warning>
  3 つのフィールドはすべて必須です。購入前にプロバイダーに確認してください。
</Warning>

#### ローカル LLM

自分のコンピュータで AI モデルを実行し、プライバシーを守りながらオフラインでも利用できます。

| ソリューション       | モデル                       | 主な用途                     |
| ------------- | ------------------------- | ------------------------ |
| **Ollama**    | Llama 3.1, Qwen, DeepSeek | 簡単なセットアップ、macOS/Linux    |
| **LM Studio** | 複数のオープンモデル                | GUI インターフェース、クロスプラットフォーム |
| **vLLM**      | カスタムデプロイ                  | 高性能、本番環境                 |

<Card title="ローカルモデルのセットアップガイド" icon="laptop" href="../resources/local-llms">
  ローカルでモデルを実行するための完全ガイド
</Card>

## SoloEnt で Codex / Claude Code のサブスクリプションを使う

すでに OpenAI Codex または Claude Code のサブスクリプションをお持ちなら、その額度を SoloEnt でそのまま再利用しつつ、SoloEnt のプロフェッショナルな執筆 Skill を活用できます——別途 API Key を購入する必要はありません。

#### Codex サブスクリプションを使う

**BYOK** を選び、API Provider リストで **OpenAI Codex** を選択して、OpenAI Codex にログインをクリックします。ログインに成功すると、Codex が提供するモデル（GPT-5.x など）をモデルリストから選べます。ChatGPT Plus または Pro のサブスクリプションを使う場合、追加の API キーは不要です。

<img src="https://mintcdn.com/soloent/4RpSHkUFmW5kEqcF/assets/images/codex.png?fit=max&auto=format&n=4RpSHkUFmW5kEqcF&q=85&s=0ec7f282fa0033e736f5ea351ab60a93" alt="BYOK 設定で API Provider に OpenAI Codex を選択し、Sign in to OpenAI Codex ボタンを表示" style={{ width: '55%' }} width="642" height="1046" data-path="assets/images/codex.png" />

#### Claude Code サブスクリプションを使う

まずローカルのコンピュータに **Claude Code CLI** をインストールし、Claude Code のサブスクリプションアカウントを紐付けて、ローカル環境で Claude Code が正常に動作することを確認します。次に **BYOK** を選び、リストで **Claude Code** を選択すれば、他の設定なしで、使いたい Claude モデルをモデルリストから直接選べます。

<img src="https://mintcdn.com/soloent/4RpSHkUFmW5kEqcF/assets/images/claudecode.png?fit=max&auto=format&n=4RpSHkUFmW5kEqcF&q=85&s=cb4ad3d2c3c24fb07806b165fe8997c1" alt="BYOK 設定で API Provider に Claude Code を選択し、Claude Code CLI Path とモデル選択項目を表示" style={{ width: '55%' }} width="632" height="980" data-path="assets/images/claudecode.png" />

## よくあるエラーの説明

| 原因           | エラーコード | エラーメッセージ                                               |
| ------------ | :----: | ------------------------------------------------------ |
| モデルが指定されていない |  `400` | `Missing model`                                        |
| 予算超過         |  `403` | `Budget exceeded`                                      |
| 無料額度を使い切った   |  `403` | `Daily free quota used up, please try again tomorrow.` |
| モデルが存在しない    |  `404` | `Model not found`                                      |

<Note>
  第三者モデルの不安定さに起因するその他のエラーについては、SoloEnt では現時点で正確な特定ができません。
</Note>

## その他のよくある質問

<AccordionGroup>
  <Accordion title="API Key が無効">
    * Key 全体をコピーしたか確認する
    * Key の有効期限が切れていないか確認する
    * プロバイダーのコンソールで再生成する
  </Accordion>

  <Accordion title="接続に失敗する">
    * ネットワーク接続を確認する
    * Base URL を確認する（OpenAI Compatible 設定の場合）
    * VPN を使わずに試す
  </Accordion>
</AccordionGroup>

## 次のステップ

<CardGroup cols={2}>
  <Card title="言語設定" icon="language" href="./language-settings">
    優先する言語を設定する
  </Card>

  <Card title="執筆を始める" icon="pen-to-square" href="../tips/create-project">
    最初のプロジェクトを作成する
  </Card>

  <Card title="ローカルモデル" icon="laptop" href="../resources/local-llms">
    自分のコンピュータで AI モデルを実行する
  </Card>

  <Card title="無料 API Key" icon="gift" href="../resources/free-api-keys">
    AI モデルへの無料アクセスを得る
  </Card>
</CardGroup>