> ## 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>
  每个注册用户可获得 **3 元人民币 / 0.5 美元**的试用额度；参与[平台活动](https://soloent.ai/zh/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 标签页下列出 Longcat Flash Lite 和 MiniMax M2.5 两个免费模型" style={{ width: '70%' }} width="720" height="948" data-path="assets/images/apikey_4.png" />

<Warning>
  免费模型仅用于用户体验工具，可能因用户过多等原因响应慢或不稳定。
</Warning>

### 订阅用户模型（VIP）

Lite、Pro、Max 三档订阅用户均可直接使用 VIP 列表中所有模型，涵盖 Anthropic、OpenAI、Google、DeepSeek 等头部供应商的最新模型，无需配置第三方 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                    | 经济实惠、灵活内容政策      |
| **智谱 AI**      | GLM-5.2                            | 故事规划、中文内容        |
| **月之暗面**       | 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" />

大多数第三方供应商需要填写全部三个字段：

<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>
  三个字段都是必填的。购买前请与供应商确认。
</Warning>

#### 本地大模型

在你自己的电脑上运行 AI 模型，保护隐私并支持离线访问。

| 方案            | 模型                        | 最佳用途             |
| ------------- | ------------------------- | ---------------- |
| **Ollama**    | Llama 3.1, Qwen, DeepSeek | 易于设置、macOS/Linux |
| **LM Studio** | 多种开源模型                    | 图形界面、跨平台         |
| **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` | `每日免费额度已用完，请明日再试。` |
| 模型不存在  | `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>