BYOK：使用自己的 API Key

01BYOK 是什么？

BYOK 是 Bring Your Own Key 的缩写，即「使用自己的 API Key」。你提供 API 账户和模型，Gen 提供图片、视频创作界面，以及任务进度、预览、下载和历史记录。

你可以在同一账户下保存多个个人提供商，并在每次生成前选择「本站渠道」或某个个人渠道。个人配置仅供当前账户使用。

不扣 Gen 积分不代表 API 免费。请在提供商后台确认余额、模型权限、价格和计费规则；Gen 不展示个人 API 的实际报价。

02连接你的 API 账户

1. 登录 Gen，进入「账户 → 媒体提供商」，点击「添加提供商」。
2. 通过表单中的链接前往 Nbility API 主站，创建有对应模型权限的 API Key，并确认 API 账户有可用额度。
3. 填写便于辨认的提供商名称，粘贴 API Key。默认 Base URL 固定为 https://api.nbility.ai，无需修改。
4. 获取或手动添加图片、视频模型，确认模型参数后保存。也可以先保存 Key，稍后再配置模型。

03获取模型，或手动配置

点击「获取模型」，Gen 会使用当前提供商的 API Key 请求 GET /v1/models。搜索返回的模型 ID，添加需要的模型并选择图片或视频类型。

也可以点击「手动添加」，填写提供商文档中的准确模型 ID 和自定义显示名称。模型 ID 区分大小写，不要填写模型的宣传名称或网页地址。

模型列表主要提供 ID，不保证返回尺寸、质量、时长、比例或参考素材能力。导入后的参数是待确认的配置起点，请按提供商文档修改；重新获取列表不会覆盖已保存的参数。

选择了视频类型，不代表该 ID 一定支持视频。模型及其参数必须同时兼容提供商与 Gen 的请求格式。

04在创作页面使用个人渠道

1. 打开图片生成或视频片场，在「生成渠道」中选择你保存的个人提供商。
2. 选择个人模型，填写提示词和该模型支持的参数；参考素材不能超过配置的上限。
3. 确认页面显示「不扣除 Gen 积分」。图片直接生成；视频先检查参数，再确认使用个人 API Key 生成。
4. 等待结果，在当前页面或历史记录中预览和下载。个人渠道的历史记录会标记提供商和计费来源。

Gen 积分为 0 也能使用个人渠道。切换回本站渠道后，仍按本站规则检查积分和收费。个人任务失败不会退还 Gen 积分；API 是否扣费或退款，以提供商记录为准。

05为什么 Base URL 不能修改？

默认仅支持 https://api.nbility.ai，表单中的 Base URL 不可编辑。管理员可在「个人提供商设置」中开启「允许自定义 Base URL」，该开关默认关闭。

开启后，仅支持兼容 New API 后端的公开 HTTPS 地址。填写根地址，并使用该提供商签发的 Key；更换地址时必须重新填写 Key。仅兼容聊天接口的服务不一定能生成图片或视频。

若管理员再次关闭开关，已有第三方配置会显示「地址已停用」，不能发起新任务。已提交的任务会继续使用提交时的提供商配置。

06密钥管理与常见问题

Key 在 Gen 服务端加密保存，编辑时不会回显。留空可保留原 Key；填写新 Key 可替换。不要把 Key 写入提示词、公开示例或截图。

修改或删除配置不会替换正在进行的任务所使用的密钥。如果需要立即撤销某个 Key，请到提供商后台撤销；使用该 Key 的未完成任务可能随之失败。