文档目录其他服务商与 API

其他服务商与 API

本页内容

本页适用于使用其他模型服务商、自定义接口,或为某项能力配置专属连接的用户。使用阿里云百炼时,可以直接阅读阿里云快速配置。

日常文字聊天使用主模型;图像、语音和记忆向量等服务可以在对应能力中选择专属连接与参数。

先认识配置中的几个名称#

名称含义
API Key服务商签发的调用密钥
服务地址或 Base URL服务商接收 API 请求的地址
模型标识接口中使用的模型名称,可能与网页上的展示名称不同
接口协议请求和响应的格式,需要与服务商接口一致
能力 API 连接保存了备注、服务类型、密钥和默认模型的一条连接配置

API Key 属于对应服务商。分享问题截图时,遮住密钥;反馈给开发者时也无需发送完整密钥。

配置主模型连接#

首次引导中可以使用“单独配置文本模型”。已经完成引导时,进入“设置 → 模型与 API → 主模型连接”。

使用预设服务商#

选择模型提供商后,界面会填写该预设的服务地址、协议和默认模型。填入自己的 API Key,首次引导中点击“保存并继续”;在设置页点击“保存主模型连接”。

保存后,可以回到聊天发送一句简短消息,确认当前账户与模型能完成实际调用。

想更换主模型时,展开“自定义设置”,在“主模型”中选择列表里的模型,或直接填写模型标识。点击“获取可用模型”可以通过当前连接读取模型列表;服务没有返回列表时,也可以按服务商提供的标识手动填写。选好后保存主模型连接。

使用自定义连接#

选择自定义连接,按服务商说明填写服务地址、接口协议、API Key 和模型标识。当前界面提供 Anthropic Messages、OpenAI Chat Completions 和 OpenAI Responses 协议选项。

模型名字相似,并不代表接口协议相同。请按实际 API 文档选择,不要把服务商的登录页或普通聊天网页填入服务地址。

如果自定义主模型支持图片输入,可按实际能力设置“图片输入”。开启后,聊天图片直接发送给该模型;关闭时,聊天图片交由已启用的图像理解能力处理。

首次配置完成后,可以继续创建第一位角色并添加好友。

添加能力 API 连接#

进入同一页面中的“能力 API 连接”,新建连接:

  1. 填写容易辨认的备注名称,例如“我的语音识别”。
  2. 选择服务类型和服务商预设。
  3. 填写 API Key、服务地址和需要的默认模型。
  4. 保存后,进入“能力”页面,在目标能力中选择这条连接。

备注名称用于在软件里辨认连接;真正调用的模型由模型字段决定。有些能力还提供自己的模型设置,具体采用方式见该能力页面的说明。

连接选择器会按服务类型筛选可用连接。如果某条连接没有出现,先核对连接类型与目标能力的要求。

按需要配置服务#

需要的功能配置位置
日常文字聊天设置 → 模型与 API → 主模型连接
图片理解能力 → 服务 → 图像理解
视频理解能力 → 服务 → 视频理解
生成或编辑图片能力 → 服务 → 图像生成
让角色说话能力 → 服务 → 语音合成
把语音转成文字能力 → 服务 → 语音识别
为长期记忆增加语义检索能力 → 服务 → 记忆向量

检查配置问题#

保存连接后,发送一句简短文字验证实际调用。遇到认证、模型、额度或连接错误时,保留错误原文,按无法聊天的排查表逐项检查。

搜索使用指南

输入关键词,搜索全部章节