接口参考 / 连接地址与协议

连接地址与协议

根据工具使用的协议，选择地址、认证方式和请求格式。

接入地址

本站提供 Chat Completions、Responses 和 Messages 三种接口。Base URL 是工具拼接请求时使用的前缀；完整 Endpoint 是实际发送请求的地址，二者不要混填。

使用场景 / 协议	工具中的 Base URL	完整调用地址
通用客户端 / Chat Completions	`https://api.asiorb.com:8443/v1`	`https://api.asiorb.com:8443/v1/chat/completions`
GPT、Codex CLI / Responses	`https://api.asiorb.com:8443/v1`	`https://api.asiorb.com:8443/v1/responses`
Claude Code、Claude SDK / Messages	`https://api.asiorb.com:8443`	`https://api.asiorb.com:8443/v1/messages`

所有地址保留 :8443。通用调用使用 Authorization: Bearer ASIORB_API_KEY；Messages 也接受 x-api-key。请求正文为 JSON，设置 Content-Type: application/json。认证细节见认证与密钥。

请求与返回结果

先用自己的 Key 查询 GET /v1/models，复制完整模型 ID。三种协议的消息字段和回答位置不同；下面按非流式 JSON 说明，流式处理见下一篇。

协议	最小请求正文	如何读取回答
Chat Completions	`{"model":"YOUR_MODEL_ID","messages":[{"role":"user","content":"你好"}]}`	`choices[0].message.content`
Responses	`{"model":"YOUR_GPT_MODEL_ID","input":"你好","store":false}`	遍历 `output` 中的 message，再读取 content 中的 output_text
Messages	`{"model":"YOUR_CLAUDE_MODEL_ID","messages":[{"role":"user","content":"你好"}],"max_tokens":4096}`	遍历 `content`，读取 type 为 text 的条目

上表中的模型 ID 都是占位符。Responses 使用已开放的 GPT 模型；Messages 使用完整 anthropic/claude-… ID。回答中还可能包含推理或工具调用条目，不要假设第一项一定是文本。

成功返回后记录响应头 x-request-id，并在消费记录核对用量与费用。各语言完整示例见系统接入；用量、结束原因与模型响应中的 ID 并不代替人民币账单。

避免重复调用

发送前持久化唯一 Idempotency-Key；同一键同一内容只受理一次，不承诺重放回答。冲突时保留 original_request_id，并查询原请求；同一键改内容返回409。建议 SDK 关闭自动重试，不明状态先查询。

断线或首次响应丢失后，查询原请求

curl --fail-with-body --get https://api.asiorb.com:8443/v1/requests \
  -H "Authorization: Bearer $ASIORB_API_KEY" \
  --data-urlencode "idempotency_key=$ASIORB_REQUEST_ID"

发送付费请求前先持久保存 ASIORB_REQUEST_ID。持久化与调用示例见系统接入；事件解析见流式响应。

继续接入

普通终端调用、自有系统、Codex CLI 与 Claude Code 各有对应教程。请使用教程列出的已支持参数；同一品牌的全部原生功能不会自动在每一种接入方式中开放。

使用目标	详细步骤
本机发送第一条消息	终端使用：macOS / Windows
接入网站和软件后台	系统接入：Python / TypeScript / cURL
使用 GPT 编程	Codex CLI 安装与配置
使用 Claude 编程	Claude Code 安装与配置
配置已有客户端	兼容客户端的字段填写

在浏览器中准备请求示例

选择模型与消息，生成可复制的代码；不会发送请求。

打开请求构建器 →