Base URL、API Key 和模型名分别怎么填?
609 字
3 分钟
Base URL、API Key 和模型名分别怎么填?
一次 API 请求至少包含四个独立信息:发往哪里、使用什么协议、由哪个 Key 认证、调用哪个模型。把它们分开检查,比反复换 Key 更有效。
按客户端的拼接规则填写地址
| 使用方式 | HiKaRi 地址 | 谁追加接口路径 |
|---|---|---|
| 需要填写 OpenAI 兼容 Base URL 的客户端 | https://hikariapi.xyz/v1 | 客户端通常追加 /chat/completions 或 /responses |
| Claude Code 或 Anthropic 风格客户端 | https://hikariapi.xyz | 客户端通常追加 /v1/messages |
| 自己编写原始 HTTP 请求 | https://hikariapi.xyz | 代码中写完整的 /v1/... 路径 |
“通常”需要结合客户端的说明确认。有的输入框要求完整 endpoint,有的只接受站点根地址。最终请求日志比输入框标签更有判断价值。
如果返回路径是 /v1/v1/chat/completions,说明版本前缀重复;如果请求发到了 /chat/completions,则可能缺少 /v1。站内“API Key → 使用”提供了已配置线路时,优先使用该入口给出的说明。
Key 是服务凭据,不是网页登录密码
在 API Key 页面创建本站密钥,按应用分别管理。不要把上游官方平台 Key、网页登录密码或订阅账号 Cookie 填到本站 API Key 输入框。
分开 Key 有助于限额、轮换与排错,但创建更多 Key 不会凭空增加账号并发。Key 绑定分组、用户权限和可用资金仍会影响请求能否通过。
模型名以目录为准
从当前 Key 的目录或模型广场复制模型 ID,不要按印象拼写。版本、大小写、前后缀和媒体分辨率后缀可能影响路由。
先查询目录的 Bash 示例:
export API_KEY='在本机填写本站密钥'curl --fail-with-body 'https://hikariapi.xyz/v1/models' \ -H "Authorization: Bearer $API_KEY"Windows PowerShell 使用 curl.exe,或按 Python 教程 请求,避免旧版 PowerShell 中 curl 别名造成参数混淆。不要把终端里填过的密钥截图发给别人。
目录列出名称,不等于声明该模型支持所有参数。工具调用、图片输入、结构化输出和思考档位需要单独核对。
按这个顺序验收
先查模型,再发短文本,然后开启流式,最后测试高级能力。若失败,保留请求路径和 HTTP 状态,按 报错清单 排查。
依据:HiKaRi 开始使用、文字 API。实时配置以主站文档为准。
文章分享
如果这篇文章对你有帮助,欢迎分享给更多人!
Base URL、API Key 和模型名分别怎么填?
https://blog.hikaripublic.xyz/posts/base-url-and-api-key/相关文章智能推荐
1
客户端接入检查清单:终端能用,为什么应用里不能用?
接入教程从协议选择、配置来源、模型能力和运行环境排查客户端接入,不把改地址视为万能兼容。
2
用 Python 标准库完成第一次 HiKaRi API 调用
接入教程无需安装 SDK,先查询 Key 可用模型,再向支持 Chat Completions 的分组发送最小请求。
3
从这里开始:HiKaRi API 接入与阅读路线图
接入教程第一次接入、排查报错、选择渠道或开展团队项目,从对应入口开始。先验证最小请求,再扩大使用。
4
AI API 成本怎么算:Token、缓存、图片与视频分开核对
模型与成本用一份明确标注假设的账单例子,区分输入、输出、缓存和媒体任务费用,避免只比较模型标价。
5
如何评测模型与 API 渠道:用自己的任务建立验收表
模型与成本从固定样本、盲评、时延到每个合格结果的成本,建立可重复的小规模选型流程。
随机文章随机推荐














