视频加载失败

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 示例:

Terminal window
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/
作者
HiKaRi Blog
发布于
2026-10-25
许可协议
保留所有权利
Profile Image of the Author
HiKaRi Blog
把 AI API 接好、用稳、算清楚。
从这里开始
第一次接入看入门指南;报错先看排查清单。实时模型、渠道和价格以 API 主站为准。
分类
标签
最新动态
站点统计
文章
13
分类
5
标签
36
总字数
11,127
运行时长
0 天
最后活动
0 天前
站点信息
构建平台
Local
博客版本
Firefly v6.16.8
文章许可
保留所有权利
文章目录