接口与客户端

Base URL 应该怎么填写？

本文档以 https://ai.example.edu.cn/v1 为示例。请替换为学校实际公布的地址。不同客户端对 /v1 的处理不同，需避免形成 /v1/v1/...。

应该填写网页地址还是 API 地址？

客户端必须填写 API Base URL，而不是控制台首页或登录页地址。如果返回 HTML 网页而不是 JSON，通常是地址填写错误或请求被认证页面拦截。

OpenAI SDK 可以直接使用吗？

可以。设置平台提供的 Base URL 和 API Key 即可。部分扩展参数只适用于特定模型，调用前应查看对应接口说明。

为什么客户端能测试连接，但无法对话？

连接测试可能只调用模型列表或发送简单请求，不能覆盖实际对话所需的模型权限、上下文长度和流式响应。请确认客户端选中的模型名称与平台模型列表完全一致。

为什么流式输出没有逐字显示？

确认请求设置了 stream: true，客户端支持 SSE 流式响应，且中间代理未缓存响应。某些模型或接口只支持非流式输出。

为什么图片、音频或文件无法发送？

目标模型必须支持对应模态，客户端也必须按照接口要求编码内容。文本模型不能仅通过添加附件变成多模态模型；过大的文件还可能超过请求体或上下文限制。

为什么客户端保存配置后仍使用旧地址？

完全退出并重新启动客户端，检查是否存在工作区级、模型级或环境变量级配置覆盖。命令行工具还应检查终端中是否保留旧的 Base URL 环境变量。