接入文档

只需替换 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/messagesClaude 原生协议
Gemini/v1beta/models/{model}:generateContentGemini 原生协议
Responses/v1/responsesOpenAI 新版 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该模型当前无可用渠道稍后重试或改用同系列其他模型