Hyperbolic:API key 与 Base URL

低成本的开源模型推理。自带你自己的 key;我们不收取任何费用。

harness 已经知道的

厂商 idhyperbolic
内置 base URLhttps://api.hyperbolic.xyz/v1
协议OpenAI 兼容的 chat completions
API keyHYPERBOLIC_API_KEY
模型发现支持——模型列表是向端点询问得来的,不是打包在发行版里的。

接入方法

export HYPERBOLIC_API_KEY="..."

key 由 Hyperbolic 签发——在哪里获取。

API key 配置与排错

官方配置指南(核对日期:2026-10-24)

Hyperbolic 已停用 .xyz 推理 API。请在当前控制台创建新的 sk_live_ 密钥,旧密钥不再受支持。重试前请核对当前套餐和余额要求。

按下方官方指南创建密钥,然后运行此命令并在提示中粘贴密钥。OHarness 会将其保存在凭据存储中。进程环境变量中的密钥优先于已保存的密钥。

oharness auth login hyperbolic

HYPERBOLIC_API_KEY 是环境变量,不是 config.json 的顶层字段。覆盖端点时,将下方 providers 配置合并到 ~/.oharness/config.json,保留其他设置。base URL 不应包含 /chat/completions。

内置目录使用 https://api.hyperbolic.xyz/v1,当前官方指南使用 https://api.hyperbolic.ai/inference/v1。要使用官方文档中的端点,请将此覆盖配置合并到 ~/.oharness/config.json。同时核对官方指南中的当前模型 ID 和密钥要求;只改 URL 不会迁移凭据或模型。

{
  "providers": {
    "hyperbolic": {
      "baseUrl": "https://api.hyperbolic.ai/inference/v1"
    }
  }
}

请求失败时如何排查

  • 401 或 403:读取响应正文,检查当前密钥、账号权限和余额。旧环境变量可能覆盖新保存的密钥。终端 export 仅对当前 shell 及其启动的进程生效。
  • 404:检查端点和服务商控制台中的完整模型 ID。429:重试前检查服务商的速率限制和配额。内置快照中的模型可能已下线。

安装 OHarness · 服务商配置 · 配置文件

无论选哪家都一样

不管底层是哪家厂商,都是同一个 agent 循环、同一套工具、同一批 MCP 服务器、同一套权限规则——会话中途在它们之间切换,什么都不用转换,因为历史记录从来不以某个厂商的格式存储。什么是 agent harness 讲了为什么这才是难点,厂商参考文档讲了目录本身。

全部 34 家厂商 · 安装 OHarness