跳到主要内容
文档

用 Ablitron API
开始构建。

Ablitron 使用 OpenAI 的 chat-completions 格式。把 base URL 指向 Ablitron,填入你的密钥,其余代码保持不变。

快速入门

接入你的工具。

选好客户端,复制现成配置,填入你的 API 密钥。两款模型使用同一个兼容 OpenAI 的端点。

1 · 安装编程客户端

npm install -g opencode-ai

2 · 在项目中保存为 opencode.json,运行 opencode,然后执行 /connect

{
  "model": "ablitron/ablitron-pro",
  "provider": {
    "ablitron": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Ablitron",
      "options": {
        "baseURL": "https://ablitron.com/v1"
      },
      "models": {
        "ablitron-pro": {
          "name": "Ablitron Pro"
        },
        "ablitron-core": {
          "name": "Ablitron Core"
        }
      }
    }
  }
}
API 参考

技术细节。

Ablitron 网关的端点、限制、计费和错误码。

将文本 chat-completions 客户端接入 Ablitron。在控制台注册并为余额充值后,即可使用网关。

模型

ablitron-pro(1M token 上下文,基于修改版 GLM-5.3)和 ablitron-core(256K token 上下文,价格减半)均为 abliterated 模型。这些是服务名称,并不代表底层模型由 Ablitron 训练。编程质量尚待基准测试。

1. 创建 API 密钥

打开控制台,注册并验证邮箱。创建密钥,复制一次后保存在你的服务器环境中。密钥可以在同一面板中撤销。充值预付额度,或选择月度订阅。

2. 发送请求

生产环境 base URL:https://ablitron.com/v1。本地开发请使用 http://localhost:4174/v1。将密钥保存在 ABLITRON_API_KEY 中。

curl https://ablitron.com/v1/chat/completions \
  -H "Authorization: Bearer $ABLITRON_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"ablitron-core","messages":[{"role":"user","content":"Write a Python binary search."}],"max_tokens":2048}'

3. 流式输出或调用工具

添加 "stream": true 即可通过 server-sent events 接收补全分块、最终用量和 [DONE] 标记。函数定义使用 tools 数组;工具结果以 role 为 tool 的消息返回,并带上对应的 tool_call_id。工具由客户端执行;Ablitron 不会执行你的代码。

输入与输出限制

预览版仅支持文本消息,最多 10,000 条消息和 64 个工具。输出上限为 1–16,384 个 token,默认 2,048。max_tokens 和 max_completion_tokens 二选一,不能同时使用。预览版不对输入额外设置 token 上限,所选模型的上下文窗口由服务提供商强制执行。HTTP 请求体上限为 16 MB;此外,需要有一个尚未用完限额的套餐,或有足以覆盖请求预留的预付额度。每个请求仅支持一个补全结果。

套餐、额度与计费

有套餐时,每个请求都会按 token 价格计入套餐的 5 小时、每周和每月限额。达到限额或没有套餐时,请求使用预付额度:推理前会按保守估计的输入大小和请求的最大输出预留额度,最终按上报的 token 用量扣费。缓存输入属于输入的一部分,按更低的价格计费。思考(reasoning)token 已包含在输出中,不会重复计费。

错误与重试

400
请求无效或不受支持。请检查消息和输出限制。
401
密钥缺失、已撤销或未激活。
403
account_suspended:该密钥所属账号已被暂停。请联系支持团队。
402
可用额度不足以完成预留。请充值或降低输出上限。
429
触发速率限制(默认每个网络、每个密钥每分钟 120 个请求,或该密钥自己的 key_rate_limit)、已有四个请求正在处理中、key_usage_limit:该密钥已达到在“设置 → API 密钥”中为其设置的每日或每月用量上限,或 usage_limit:你的套餐已达限额,且没有预付额度。error.resets_at(Unix 时间)和 Retry-After 响应头会告诉你何时刷新。
502
无法确认模型响应或用量。重试前请先检查控制台。
503
推理服务或其他必需服务未启用。

报告问题时,请保存 X-Request-ID 响应头。推理不会自动重试。如果连接中断或服务器出错后无法确认用量,预留会保持待定状态 15 分钟;之后按你已收到文本的保守估算结算,如果没有返回任何内容,则释放预留且不扣费。非流式请求约 170 秒后会以 504 request_timeout 结束,提示词按估算计费,因此长回答请使用流式输出。重试是一个新请求,可能产生额外用量。

网关处理的数据

请求会转发给推理服务提供商。本地用量账本存储请求 ID、时间戳、模型别名、token 数和扣费,不存储提示词或输出文本。客户的 API 密钥以哈希形式存储。服务提供商一侧的数据处理方式及适用的服务条款,需要你结合自己的使用场景自行评估;我们不承诺端到端零数据留存。

想问就问。
有问必答。

几秒钟即可开始对话,无需绑卡。