本页适用于使用其他模型服务商、自定义接口,或为某项能力配置专属连接的用户。使用阿里云百炼时,可以直接阅读阿里云快速配置。
日常文字聊天使用主模型;图像、语音和记忆向量等服务可以在对应能力中选择专属连接与参数。
先认识配置中的几个名称#
| 名称 | 含义 |
|---|---|
| API Key | 服务商签发的调用密钥 |
| 服务地址或 Base URL | 服务商接收 API 请求的地址 |
| 模型标识 | 接口中使用的模型名称,可能与网页上的展示名称不同 |
| 接口协议 | 请求和响应的格式,需要与服务商接口一致 |
| 能力 API 连接 | 保存了备注、服务类型、密钥和默认模型的一条连接配置 |
API Key 属于对应服务商。分享问题截图时,遮住密钥;反馈给开发者时也无需发送完整密钥。
配置主模型连接#
首次引导中可以使用“单独配置文本模型”。已经完成引导时,进入“设置 → 模型与 API → 主模型连接”。
使用预设服务商#
选择模型提供商后,界面会填写该预设的服务地址、协议和默认模型。填入自己的 API Key,首次引导中点击“保存并继续”;在设置页点击“保存主模型连接”。
保存后,可以回到聊天发送一句简短消息,确认当前账户与模型能完成实际调用。
想更换主模型时,展开“自定义设置”,在“主模型”中选择列表里的模型,或直接填写模型标识。点击“获取可用模型”可以通过当前连接读取模型列表;服务没有返回列表时,也可以按服务商提供的标识手动填写。选好后保存主模型连接。
使用自定义连接#
选择自定义连接,按服务商说明填写服务地址、接口协议、API Key 和模型标识。当前界面提供 Anthropic Messages、OpenAI Chat Completions 和 OpenAI Responses 协议选项。
模型名字相似,并不代表接口协议相同。请按实际 API 文档选择,不要把服务商的登录页或普通聊天网页填入服务地址。
如果自定义主模型支持图片输入,可按实际能力设置“图片输入”。开启后,聊天图片直接发送给该模型;关闭时,聊天图片交由已启用的图像理解能力处理。
首次配置完成后,可以继续创建第一位角色并添加好友。
添加能力 API 连接#
进入同一页面中的“能力 API 连接”,新建连接:
- 填写容易辨认的备注名称,例如“我的语音识别”。
- 选择服务类型和服务商预设。
- 填写 API Key、服务地址和需要的默认模型。
- 保存后,进入“能力”页面,在目标能力中选择这条连接。
备注名称用于在软件里辨认连接;真正调用的模型由模型字段决定。有些能力还提供自己的模型设置,具体采用方式见该能力页面的说明。
连接选择器会按服务类型筛选可用连接。如果某条连接没有出现,先核对连接类型与目标能力的要求。
按需要配置服务#
| 需要的功能 | 配置位置 |
|---|---|
| 日常文字聊天 | 设置 → 模型与 API → 主模型连接 |
| 图片理解 | 能力 → 服务 → 图像理解 |
| 视频理解 | 能力 → 服务 → 视频理解 |
| 生成或编辑图片 | 能力 → 服务 → 图像生成 |
| 让角色说话 | 能力 → 服务 → 语音合成 |
| 把语音转成文字 | 能力 → 服务 → 语音识别 |
| 为长期记忆增加语义检索 | 能力 → 服务 → 记忆向量 |
检查配置问题#
保存连接后,发送一句简短文字验证实际调用。遇到认证、模型、额度或连接错误时,保留错误原文,按无法聊天的排查表逐项检查。