黑洞智能体
黑洞智能体BLACK HOLE AGENTS
跳转到正文

模型 API 接入

国内模型 API，接入你的工作流

通过黑洞智能体的多模型 API 入口，将 DeepSeek、GLM、千问等国内模型接入应用。选择具体型号，准备自己的 API Key，从一条短请求开始。

查看模型与价格进入用户中心

从实际模型目录选择

当前目录列有 DeepSeek、智谱 GLM、千问、Kimi、MiniMax、小米 MiMo 与腾讯混元的文本型号。查看准确模型 ID、计价单位和当前状态，再决定用于哪项任务。

准确型号、访问权限与价格以当前目录和账户为准。专题介绍的模型范围可能更广，接入时请使用模型目录中的准确 ID。

客户端与程序使用同一个接入地址

默认 Base URL 为 https://blackholeagent.cn/v1。黑洞客户端内置连接入口使用此地址，用户输入 API Key 即可发起配置；自行开发程序时，将地址和密钥分别放入配置或环境变量。

文本请求示例采用 POST /v1/chat/completions。模型 ID 必须使用黑洞目录中的准确值；厂商官网的动态别名或你给模型起的显示名称，不能直接替代它。

先估算，再看实际用量

模型目录区分输入、输出及适用的缓存价格。比较费用时先统一计价单位，再按实际请求的用量分类估算；没有标价的能力不要自行视作免费。

一次任务可能产生多轮模型调用。先运行短文本示例，再用自己的代表性任务观察费用与结果，比只比较单个输入价格更有意义。实际表现要结合模型、输入内容和当时的服务状态评估。

开始使用

开始你的第一次接入

  1. 选择一个具体模型

    打开模型目录，选择适合任务的型号，记录准确 ID 和价格单位。首次验证使用简单文本请求。

  2. 准备自己的 API Key

    在用户中心查看可用的密钥与账户状态，将密钥保存在自己的配置中。

  3. 填写地址与模型 ID

    客户端选择内置黑洞服务商并填写 API Key；程序使用默认 Base URL 和目录中的模型 ID，通过 Bearer 认证传递密钥。

  4. 执行一条短请求并检查结果

    核对 HTTP 状态、回复与用量，再用相同的真实任务评估候选模型。出错时保留脱敏错误信息。

文本调用格式示例
export BLACK_HOLE_API_KEY="YOUR_API_KEY"
curl https://blackholeagent.cn/v1/chat/completions \
  -H "Authorization: Bearer $BLACK_HOLE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4.1-flash-1017",
    "messages": [{"role": "user", "content": "你好"}],
    "stream": false
  }'

使用范围

  • 黑洞智能体由广元市黑洞科技有限公司提供。模型厂商名称说明模型来源；本站提供自己的 API 接入服务。
  • 工具、视觉、上下文和输出格式支持因型号而异，接入前按实际接口验证。模型请求内容会发送到相应服务。

常见问题

AI 中转站与模型官方网站有什么区别？

模型厂商研发模型；黑洞提供自己的接入服务与账户入口。选择服务时，应分别查看模型来源、接入地址、计费规则和数据处理方式。

在黑洞客户端里还要手动填写地址吗？

新配置可使用内置黑洞服务商，默认地址已经提供，输入自己的 API Key 发起连接即可。已有自定义配置应先核对当前连接，不要把其他提供商密钥填入黑洞入口。

所有国内模型都已经可以调用吗？

请以当前模型目录和账户可用范围为准。国内模型专题还会介绍官方资料，专题中出现的型号不一定已通过黑洞 API 提供服务。