AIRI 配置 BytePlus Coding Plan 聊天模型完整指南从 API Key 申请到模型选择【免费下载链接】airi Self hosted, you-owned Grok Companion, a container of souls of waifu, cyber livings to bring them into our worlds, wishing to achieve Neuro-samas altitude. Capable of realtime voice chat, Minecraft, Factorio playing. Web / macOS / Windows supported.项目地址: https://gitcode.com/GitHub_Trending/ai/airiBytePlus Coding Plan 是 BytePlus 面向代码场景推出的订阅制服务与通用 BytePlus 按量计费 API 使用不同的 API 路由。本文基于 AIRI 开源项目中的官方文档 docs/content/ko/docs/manual/config/providers/consciousness/byteplus-coding-plan.md结合仓库内的提供者定义与测试用例完整讲解如何在 AIRI 中申请凭据、填入提供者卡片、验证配置并选择模型同时剖析其在源码层面的实现细节帮助你正确区分 Coding Plan 与普通 BytePlus 配置避免踩坑。为什么 AIRI 需要独立的 BytePlus Coding Plan 提供者BytePlus 官方同时提供两类服务入口通用模型 API按 token 计费默认 Base URL 为https://ark.ap-southeast.bytepluses.com/api/v3在 AIRI 中对应「BytePlus」提供者卡片Coding Plan 订阅服务面向开发者订阅套餐使用独立的 API 路由Base URL 为https://ark.ap-southeast.bytepluses.com/api/coding/v3对应「BytePlus Coding Plan」提供者卡片。两者的 Base URL 仅相差一个coding路径段但认证与模型可用范围完全不同。如果你的 BytePlus 账户开通的是Coding Plan 订阅就必须选择 BytePlus Coding Plan 卡片而非普通 BytePlus否则请求会因路由或额度不匹配而失败。这一点在 AIRI 的源码中体现得非常明确普通 BytePlus 与 Coding Plan 被定义为两个独立注册的提供者并分别通过测试用例锁定各自的 Base URL见 ark-providers.test.tsbyteplus - https://ark.ap-southeast.bytepluses.com/api/v3 byteplus-coding-plan - https://ark.ap-southeast.bytepluses.com/api/coding/v3两者的定义都基于一个共享的工厂函数createArkChatProviderDefinition位于 ark-shared.ts该工厂负责构建配置表单、创建 OpenAI 兼容客户端、模型列表与校验逻辑所以两张卡片在 AIRI 中的交互方式完全一致只是路由和模型清单不同。第一步准备 BytePlus Coding Plan 凭据在 AIRI 中配置前你需要先在 BytePlus 侧完成以下操作登录 BytePlus ModelArk 控制台应用中心区域为arkap-southeast-1确认你的账户已购买并激活Coding Plan订阅在应用中心创建应用并签发API Key。API Key 安全须知不要将 API Key 或端点凭据提交到 Git 仓库包括配置文件、提交历史不要在截图、日志或任何对外文档中包含 Key不要与任何人共享你的 Key如需在多个设备上使用建议为不同用途签发独立 Key 以便单独吊销。AIRI 提供者配置表单中的 API Key 输入框以type: password渲染见 ark-shared.ts即输入内容在界面上默认被遮蔽降低截屏泄露风险。第二步在 AIRI 中配置提供者打开配置入口按以下路径进入提供者配置页设置 → 提供者 → 聊天 → BytePlus Coding Plan这里有两个容易混淆的入口请务必选择带Coding Plan后缀的卡片BytePlus普通按量计费 APIBytePlus Coding Plan订阅制代码服务。在 i18n 中两者分别以byteplus与byteplus-coding-plan两个 key 注册见 ko/settings.yaml对应源码中的两个独立提供者模块 byteplus/index.ts 与 byteplus-coding-plan/index.ts二者通过 providers/index.ts 统一注册。填写配置字段表单由arkProviderConfigSchema定义见 ark-shared.ts共两个字段字段必填说明默认值API Key是BytePlus 控制台签发的 Coding Plan Key密码输入框无Base URL否兼容 API 路由一般保持默认即可https://ark.ap-southeast.bytepluses.com/api/coding/v3关键要点保持默认 Base URL除非 Coding Plan 官方文档另行告知其他兼容 API 路由否则不要修改。修改为错误的地址会导致连接校验失败模型不是手动输入的本表单没有 Endpoint ID 或模型输入框模型全部来自 AIRI 的静态提供者模型列表由配置完成后的模型选择步骤确定Base URL 字段在源码中通过.default(defaultBaseUrl)预填见 ark-shared.ts因此只填 API Key 即可直接保存。Coding Plan 可用模型清单模型列表定义在 byteplus-coding-plan/index.ts目前内置 6 个模型统一使用byteplus-coding-plan/前缀标识模型 ID列表中的显示名完整 ID含前缀dola-seed-2.0-probyteplus-coding-plan/dola-seed-2.0-prodola-seed-2.0-litebyteplus-coding-plan/dola-seed-2.0-litebytedance-seed-codebyteplus-coding-plan/bytedance-seed-codeglm-4.7byteplus-coding-plan/glm-4.7kimi-k2.5byteplus-coding-plan/kimi-k2.5gpt-oss-120bbyteplus-coding-plan/gpt-oss-120b列表由extraMethods.listModels动态生成见 ark-shared.ts每个模型被包装为byteplus-coding-plan/id的形式返回给上层模块。测试用例也验证了这一输出见 ark-providers.test.ts。说明以上为撰写本文时仓库中内置的静态清单。若你的 Coding Plan 套餐包含列表之外的模型需要关注 AIRI 后续版本对该提供者定义的更新。第三步校验配置并选择模型设置有效性校验AIRI 在配置修改过程中会自动执行校验当表单中出现Ping API按钮时表示可以进行真实请求测试点击即可验证连接与 Key 是否有效校验失败时表单会给出错误提示便于即时修正。校验的底层实现自动校验并非简单判断「Key 是否非空」而是由createOpenAICompatibleValidators提供的一系列检查构成见 ark-shared.ts依次执行三种检查Connectivity连接检查直接以GET方式轻量请求{baseUrl}/models不调用生成接口网络不通或地址错误时快速失败见 openai-compatible.test.tsModelList模型列表检查向服务端请求模型列表确认路由可访问ChatCompletions对话探测从模型列表中取第一个可用模型发起最小化对话请求max_tokens固定为 16部分服务端拒绝小于 16 的请求源码测试对这一点有专门注释见 openai-compatible.test.ts。此外还有一层前置条件validationRequiredWhen仅在apiKey非空时才触发校验见 ark-shared.ts避免空表单反复报错。通过「模型选择 →」进入意识模块校验通过后点击表单中的模型选择 →按钮即可打开设置 → 模块 → 意识在这里从上方静态清单中选择要使用的模型。所选模型即成为 AIRI「意识Consciousness」模块的聊天大脑。模型 ID 前缀如何被剥离一个值得了解的底层细节上层传入的模型 ID 带byteplus-coding-plan/前缀而发送给 BytePlus 服务端时前缀会被剥除。createProvider包装了 OpenAI 兼容客户端见 ark-shared.ts其中的stripModelPrefix负责去掉前缀byteplus-coding-plan/dola-seed-2.0-pro - dola-seed-2.0-pro同时如果请求带有reasoning选项会将其转换为服务端认可的thinking参数thinking: { type: requestOptions.reasoning }说明该提供者天然支持思维链开关。测试用例同样验证了「带前缀列出、去前缀请求」的行为见 ark-providers.test.ts。第四步问题排查症状可能原因与对策校验失败连接检查不通过API Key 是否来自已激活的 BytePlus Coding PlanBase URL 是否被改成了非默认值对照https://ark.ap-southeast.bytepluses.com/api/coding/v3恢复默认校验失败模型探测不通过检查网络到ark.ap-southeast.bytepluses.com的连通性确认 Key 未过期、未被吊销模型列表中某个模型被拒绝你的 Coding Plan 套餐可能未包含该模型的访问权限换用清单中其他模型或到 BytePlus 控制台核对套餐模型范围误选了「BytePlus」卡片Coding Plan 用户必须使用「BytePlus Coding Plan」卡片二者路由不同/api/v3vs/api/coding/v3想要使用清单之外的模型当前模型来自 AIRI 的静态提供者列表byteplus-coding-plan/index.ts等待版本更新或关注官方文档是否引入动态模型列表源码速查以下文件可以帮助你深入理解 BytePlus Coding Plan 提供者的完整实现链路byteplus-coding-plan/index.ts提供者定义含默认 Base URL 与静态模型清单ark-shared.tsArk 系提供者共享工厂含配置 Schema、前缀剥离、thinking 映射与校验器装配byteplus/index.ts普通 BytePlus 提供者定义与 Coding Plan 区分providers/index.ts提供者注册入口ark-providers.test.ts锁定两个提供者 Base URL 与模型列表的测试openai-compatible.test.ts连接、模型列表与对话探测三类校验的测试attributes.tsbyteplus-coding-plan被归类为付费云服务paid/cloud会显示在提供者目录的相应筛选中。整体来看BytePlus Coding Plan 在 AIRI 中遵循「独立的订阅型路由 静态模型清单 OpenAI 兼容客户端 三级自动校验」的设计配置的核心只有一步选对卡片、填对 Key、保持默认 Base URL其余交给 AIRI 自动完成。【免费下载链接】airi Self hosted, you-owned Grok Companion, a container of souls of waifu, cyber livings to bring them into our worlds, wishing to achieve Neuro-samas altitude. Capable of realtime voice chat, Minecraft, Factorio playing. Web / macOS / Windows supported.项目地址: https://gitcode.com/GitHub_Trending/ai/airi创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考