# 接入 AstraFlow
<subtitle>使用 AstraFlow API Key 一键导入 Bomiio 创作所需的可用模型。</subtitle>

Bomiio 当前面向创作者的模型接入统一使用 AstraFlow 星图。Bomiio 与 AstraFlow 共用登录入口和账号体系，因此这里不再单独介绍账号注册流程。

## 首次接入

1. 在 Bomiio 首页或无限画布右上角打开“设置”，切换到“模型渠道”。
2. 在 AstraFlow（星图）卡片中点击“获取 API Key”，前往 AstraFlow 创建或查找 Key。
3. 返回 Bomiio，在下拉框中选择需要使用的 API Key；如果没有自动列出，也可以手动填写。
4. 点击“一键接入”。
5. 等待页面显示“已接入”，并确认出现可用模型数量。

<div align="center">
  <a href="https://cdnv2-cache.udelivrs.com/2026/07/a05fb704445c10ff9bf932110a1eb405_1785135110402.png">
    <img src="https://cdnv2-cache.udelivrs.com/2026/07/a05fb704445c10ff9bf932110a1eb405_1785135110402.png" alt="在模型渠道中获取并接入 AstraFlow API Key" style="display: block; width: 100%; max-width: 960px; height: auto; margin: 0 auto; box-shadow: none !important; filter: none !important;" />
  </a>
</div>

> “获取 API Key”用于进入 AstraFlow 获取凭证；取得 Key 后仍需返回 Bomiio 选择对应项并点击“一键接入”。截图中的 Key 名称仅作示例，不代表固定配置。

<div align="center">
  <a href="https://cdnv2-cache.udelivrs.com/2026/07/7948e0b41f5a3287250e6e6feb313133_1785122423830.png">
    <img src="https://cdnv2-cache.udelivrs.com/2026/07/7948e0b41f5a3287250e6e6feb313133_1785122423830.png" alt="AstraFlow 接入后可用的模型列表" style="display: block; width: 100%; max-width: 960px; height: auto; margin: 0 auto; box-shadow: none !important; filter: none !important;" />
  </a>
</div>

> 上图展示接入后的模型列表，不包含 API Key 输入区域。模型名称和数量会随当前 Key 变化，不作为固定清单。

接入完成后，Bomiio 会根据当前 Key 导入可用模型。具体模型及生成方式以 AstraFlow 当前授权和 Bomiio 界面可选项为准。

## 接入后的基础检查

在创建首集短剧前，打开编导台配置，确认以下位置都能选择可用项：

- 剧本模型。
- 调度模型。
- 图像模型。
- 视频模型。

如果某项为空或标记为不可用，请先回到模型 API 页面检查接入状态，不要直接提交剧本处理。

## 切换 API Key

已接入时，页面会以遮罩形式显示当前 Key。需要切换时：

1. 在“切换 API Key”处选择或填写新的 Key。
2. 点击“更新”。
3. 等待模型列表刷新。
4. 重新检查编导台配置中的模型选择。

不同 Key 对应的可用模型可能不同。切换后，原配置中的某些模型可能变为不可用，需要重新选择。

## 断开接入

断开 AstraFlow 会移除当前 Key 和相关模型绑定。正在创作的画布不会因此自动删除，但依赖模型的后续生成将无法继续，直至重新接入并完成配置。

## API Key 安全

- 不要在提示词或剧本正文中写入 API Key。
- 不要发送包含完整 Key 的截图。
- 排障时只描述错误提示和操作步骤，不粘贴 Key。
- 怀疑 Key 泄漏时，应在 AstraFlow 中停用或更换 Key，再回到 Bomiio 更新。

## 常见问题

### 一键接入失败

确认 Key 没有多余空格且仍然有效，然后重试。如果页面提示网络错误，稍后重新提交；不要连续创建多个重复配置。

### 已接入但没有模型

检查该 Key 在 AstraFlow 中是否有可用模型权限，然后更新 Key 或重新接入。模型恢复后，再回到编导台配置完成基础检查。

### 某种生成方式无法选择

不同模型支持的输入和生成方式不同。以当前界面可选项为准；如果所选模型不支持当前方式，请选择界面中可用的方式或更换可用模型。

## 下一步

- [创建画布](/docs/bomitv/getting-started/create-canvas.md)
- [快速生成 1 集短剧](/docs/bomitv/getting-started/first-episode.md)
- [编导台配置](/docs/bomitv/director/configuration.md)