使用教程 / 系统接入
系统接入
把模型接入开发工具、网站后台、软件服务和自动化流程。
先选择接入形式
现成工具填写连接参数；自有产品由服务器调用接口。终端与系统接入都使用本站创建的 API Key。
你的用户你的后台
在此保存 API KeyASIORB所选模型
在此保存 API KeyASIORB所选模型
开发工具怎么配置
选择工具的自定义供应商或兼容接口选项，填写地址、Key 与模型 ID。先核对它使用的是哪一种接口。
| 使用方式 | 接口格式 | Base URL |
|---|---|---|
| 通用客户端 / 自有系统 | Chat Completions | https://api.asiorb.com:8443/v1 |
| Codex CLI / GPT | Responses | https://api.asiorb.com:8443/v1 |
| Claude Code / Claude SDK | Messages | https://api.asiorb.com:8443 |
- 供应商选择相应兼容格式，粘贴上表对应的 Base URL。
- 填入本站创建的 API Key；模型填写
/v1/models返回的完整 ID。 - 保存后发送一次简短问题，再在个人中心核对模型和扣费。
网站或软件怎么调用
让自己的后台接收用户问题，再调用 ASIORB，把答案返回前端。完整 Key 保存在后台环境变量，不能写进网页脚本或公开分发的 App。
Python 安装 openai；Node.js 安装同名 npm 包。先设置环境变量 ASIORB_API_KEY，为每个业务请求生成并持久保存唯一 ASIORB_REQUEST_ID。以下示例可切换语言。
代码在你的服务端或本机终端运行。先设置环境变量 ASIORB_API_KEY 为个人中心创建的 Key，不要把它放进网页前端。 ASIORB_REQUEST_ID 对应同一次逻辑请求，查询与故障恢复沿用该值。
将 YOUR_MODEL_ID 替换为你的 API Key 可用模型 ID。可用模型可通过 /v1/models 查询。
cURL 示例
# 先持久保存 ASIORB_REQUEST_ID；curl 不配置自动重试。
curl --fail-with-body -N --max-time 210 https://api.asiorb.com:8443/v1/chat/completions \
-H "Authorization: Bearer $ASIORB_API_KEY" \
-H "Idempotency-Key: $ASIORB_REQUEST_ID" \
-H "Content-Type: application/json" \
--data-binary @- <<'ASIORB_BODY'
{
"model": "YOUR_MODEL_ID",
"messages": [
{
"role": "user",
"content": "你好，请用一句话介绍自己。"
}
],
"stream": true,
"stream_options": {
"include_usage": true
},
"max_tokens": 4096
}
ASIORB_BODY
# 断线或收到流内 error 时，单独执行以下查询；不要重新发送上面的 POST。
curl --fail-with-body --max-time 30 --get https://api.asiorb.com:8443/v1/requests \
-H "Authorization: Bearer $ASIORB_API_KEY" \
--data-urlencode "idempotency_key=$ASIORB_REQUEST_ID"上线前核对
保留请求编号，限制每位用户的用量，并核对成功、超时和工具调用时的消费记录。
- 为每个应用创建独立 Key，设置预算和允许使用的模型。
- 流式结果必须完整结束；超时后先查原请求，不自动更换编号重发。
- 模型提出工具调用时，由你的程序校验参数、执行操作并回传结果。工具的每轮继续调用单独计费。