Gonka API — 连接并试用
为智能体、编程和后台任务提供推理。三种方式连接网络模型:从现成的 API 到自建 Gateway。
获取密钥,连接 API。
- 01
选择经纪商
在其网站注册并创建 API 密钥。
- 02
填写配置
在工具中填写 Base URL、该经纪商的密钥和准确的 Model ID。
- 03
开始推理
运行智能体、自动化流程或首次请求。
使用熟悉的工具
一个 API,多种任务
无需注册或 API 密钥,即可在此试用模型。脚本、智能体和后台任务请连接所选经纪商的 API。
首次请求示例 · Python
import json, os
from urllib.request import Request, urlopen
request = Request(
os.environ["GONKA_BASE_URL"] + "/chat/completions",
headers={
"Authorization": "Bearer " + os.environ["GONKA_API_KEY"],
"Content-Type": "application/json",
},
data=json.dumps({
"model": os.environ["GONKA_MODEL"],
"messages": [{"role": "user", "content": "Hello, Gonka!"}],
}).encode(),
)
with urlopen(request) as response:
print(json.load(response)["choices"][0]["message"]["content"])OpenBroker:以 GNK 支付网络费用
如果您持有 GNK,希望连接应用或向用户发放密钥,OpenBroker 可代管 Gateway 和 devshards。
- 01
创建账户
填写组织、邮箱和 Gonka 钱包地址。
- 02
充值 GNK
向指定地址转入原生 GNK。当前 quickstart 要求至少 100 GNK 才能激活;请核查最新文档。
- 03
生成密钥
激活后在控制面板创建 obk- 密钥。
- 04
连接应用
填写 endpoint、密钥和模型,无需自行部署 Gateway。
OpenBroker 文档说明加价为 0%:支付网络执行费用,包括重试。这可避免经纪商加价;总费用仍取决于 token 数量和请求执行情况。
OpenBroker 运营白名单钱包、escrows 和 Gateway。应用的 API 密钥由您创建。
自建 Gateway 与 devshards
适合需要自行持有 escrow 密钥、管理会话和直接与网络结算的运营者。基础设施由您控制和维护。
- 01
通过治理获取访问权限
Escrow 创建地址须加入链上白名单,由主机治理投票更新。提交申请不等于获得权限。
- 02
自己的服务器和密钥
在自己的机器运行 Gateway,配置访问权限,为专用钱包充值 GNK。
- 03
管理 devshards
开启会话、路由请求、管理轮换并与网络结算。
Devshard 是由网络存款和请求计费支持的推理会话。Gateway 管理其生命周期;它不是模型,也不是 GPU 节点。
为何目前限制访问?
直接访问 devshards 会影响网络运行和请求核算。在防护机制完善期间,安全和稳定也依赖于有限的运营者范围。声誉、贡献和明确的使用场景有助于社区评估申请;最终由治理决定。
开放访问是预期的发展方向。当前文档没有确定取消白名单的日期,不能将 2027 年视为保证的期限。
首次请求前
开始需要 GNK 吗?
通过普通经纪商不一定需要:支付方式和奖励取决于服务商。OpenBroker 和自建 Gateway 使用原生 GNK。
有哪些模型?
目录会变化。请从服务商复制准确的 Model ID;列入目录不代表当前有空闲容量。
演示需要密钥吗?
不需要。费用由 GNK Space 支付。达到限制或模型不可用时,请稍后再试。在自己的 IDE 或应用中使用时,请向经纪商申请个人密钥。
只能用于聊天吗?
不是。API 可用于智能体、文本处理和后台任务。工具调用等功能须核查经纪商及模型支持。