接入文档
只需替换 API 地址与密钥,即可通过统一的网关调用所有模型。接入地址:https://api.hj688.cn(与主站 www.hj688.cn 同域)。
本站兼容 OpenAI / Anthropic / Gemini / Responses 四种协议。你的应用原本用哪家协议,就继续用哪家的 SDK,只改
base_url 和密钥即可。
快速开始
1. 注册并登录后,进入控制台 → 令牌管理,创建一个 sk- 开头的 API 令牌;
2. 将接口地址替换为 https://api.hj688.cn,密钥替换为你的令牌;
3. 在请求的 model 字段填入模型广场中的任意模型名,即刻调用。
接口端点
| 协议 | 端点 | 说明 |
|---|---|---|
| OpenAI | /v1/chat/completions | 对话补全,绝大多数应用默认使用 |
| OpenAI | /v1/embeddings | 文本向量化 |
| Anthropic | /v1/messages | Claude 原生协议 |
| Gemini | /v1beta/models/{model}:generateContent | Gemini 原生协议 |
| Responses | /v1/responses | OpenAI 新版 Responses 协议 |
OpenAI 协议调用
curl · /v1/chat/completions
curl https://api.hj688.cn/v1/chat/completions \
-H "Authorization: Bearer sk-你的令牌" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-6-astra",
"messages": [
{ "role": "user", "content": "你好,介绍一下你自己" }
]
}'
Anthropic 协议调用
curl · /v1/messages
curl https://api.hj688.cn/v1/messages \
-H "x-api-key: sk-你的令牌" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-5",
"max_tokens": 1024,
"messages": [
{ "role": "user", "content": "你好,介绍一下你自己" }
]
}'
流式输出
在请求体中加入 "stream": true 即可开启 SSE 流式返回,数据格式与官方协议完全一致:
SSE 响应片段
data: {"choices":[{"delta":{"content":"你"}}]}
data: {"choices":[{"delta":{"content":"好"}}]}
data: [DONE]
计费说明
本站按 Token 用量计费,输入 / 输出 / 缓存读取分别计价(详见模型广场)。费用 = 用量 × 模型单价 × 分组倍率,实时从令牌余额中扣除。
提示:请为令牌设置额度上限,避免异常调用产生意外消耗。令牌额度用尽后调用会被拒绝,可随时充值续用。
常见错误码
| 状态码 | 含义 | 处理建议 |
|---|---|---|
| 401 | 令牌无效或已删除 | 检查密钥是否正确、是否被禁用 |
| 403 | 令牌无权访问该模型 / 分组 | 在控制台调整令牌可用的模型范围 |
| 429 | 触发限流或余额不足 | 降低并发,或充值 / 提高令牌额度 |
| 500 | 上游服务异常 | 稍后重试;持续失败请联系管理员 |
| 503 | 该模型当前无可用渠道 | 稍后重试或改用同系列其他模型 |