Developer guide / Chat Completions

LLM Gateway API

统一的聊天 API。使用公开模型名发送请求，网关会按问题内容选择实际处理模型。

服务可用 · 定向接入当前关闭公开注册。已有 One-API 令牌可调用；新用户请向运营者申请接入。

当前仅开放定向测试，获取令牌请联系运营者。

01 / Endpoint

连接信息

API 地址https://llmgateway.port.toms.chat/v1/chat/completions

鉴权方式Authorization: Bearer YOUR_ONE_API_TOKEN

公开模型名

agent-auto

只支持 Chat Completions 的文本请求；设置 stream: true 可接收 SSE 流式响应。图片输入当前不可用。模型列表也可在取得令牌后请求 GET /v1/models。

02 / Quick start

发送第一条请求

将占位符换成运营者提供的 One-API 令牌，并通过 HTTPS 调用。

curl · 普通响应

export ONE_API_TOKEN="YOUR_ONE_API_TOKEN"
curl "https://llmgateway.port.toms.chat/v1/chat/completions" \
  -H "Authorization: Bearer $ONE_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"model":"agent-auto","messages":[{"role":"user","content":"你好，请简短介绍你自己"}],"stream":false}'

curl · 流式响应

curl --no-buffer "https://llmgateway.port.toms.chat/v1/chat/completions" \
  -H "Authorization: Bearer $ONE_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"model":"agent-auto","messages":[{"role":"user","content":"你好，请简短介绍你自己"}],"stream":true}'

Python · 标准库

import json, os, urllib.request

url = "https://llmgateway.port.toms.chat/v1/chat/completions"
payload = {'model': 'agent-auto', 'messages': [{'role': 'user', 'content': '你好，请简短介绍你自己'}], 'stream': False}
request = urllib.request.Request(
    url, json.dumps(payload).encode("utf-8"),
    {"Authorization": "Bearer " + os.environ["ONE_API_TOKEN"],
     "Content-Type": "application/json"},
)
with urllib.request.urlopen(request, timeout=120) as response:
    data = json.load(response)
print(data["choices"][0]["message"]["content"])

03 / Troubleshooting

常见返回

401 / 403检查令牌、账号权限与可用额度。

400检查请求格式；内容规则拦截或图片输入也会返回 400。

404请确认使用 /v1/chat/completions；其他下游接口尚未开放。

5xx服务或上游暂时不可用，稍后重试并向运营者提供请求时间。

公开地址使用受信任的 HTTPS 证书。请保持客户端的证书校验开启。