YOUR NEXT IDEA, CONNECTED.
让灵感,
一路畅通.
从第一行代码,到下一个可能。
一个入口,连接你的 AI 创造力。
让熟悉的工具,继续好用。
LINGSHU / ZODIAC COLLECTION VOL. 01
十二星座模型图鉴
各有光芒,自成宇宙。
YOUR MODELS, YOUR GROUP.
选一个分组,连接全部模型。
分组折扣与模型单价一目了然。创建一个密钥,即可在编辑器中切换组内模型。
一个入口,多种可能。
通过兼容的模型 API 连接你的编辑器、应用与自动化工作流。切换模型,让思路继续。
选择,看得见。
模型、渠道、输入输出与缓存价格放在一起。按任务选择,在开始之前了解成本。
让通知找到你。
账户与系统消息集中管理。在线实时提醒,离线后仍可查询,每一步都有记录。
from openai import OpenAI
client = OpenAI(
base_url="YOUR_RELAY_URL/v1",
api_key="YOUR_API_KEY"
)
response = client.chat.completions.create(
model="YOUR_MODEL_ID",
messages=[{
"role": "user",
"content": "Build something remarkable."
}]
)接入指南
进入控制台 ↗01 / 快速开始
- 注册独立用户账户,进入控制台。
- 中选择模型,并查看它的支持协议。
- 选择渠道分组,点击「创建此分组密钥」,或在控制台「API Key」中选择分组创建。一个密钥可调用该分组下所有启用模型,完整密钥登录后可在密钥详情随时查看和复制。
- 账户需有可用余额才能调用模型。余额和请求记录可在控制台查询。
02 / API 请求
Relay Base URL:https://adminl.tools.ac.cn/v1。Base URL 本身不区分协议,请按客户端选择请求路径;示例中的 YOUR_MODEL_ID 必须替换为模型目录里的调用标识,不能填写模型显示名称。
除 Messages 外,OpenAI 兼容接口使用 Authorization: Bearer YOUR_API_KEY;Messages 使用 x-api-key 和 anthropic-version: 2023-06-01。所有请求都需要 Content-Type: application/json,并且模型必须同时被 API Key 授权、渠道启用且有可用余额。
查询模型列表 · GET /v1/models
返回当前 API Key 可以调用的模型。先用这个接口确认模型标识和协议,再发起生成请求。
curl https://adminl.tools.ac.cn/v1/models \
-H "Authorization: Bearer YOUR_API_KEY"成功返回 { object: "list", data: [...] };单个模型包含 id、object、created 和 owned_by。
Chat Completions · POST /v1/chat/completions
适用于 OpenAI Chat Completions SDK 和大多数 OpenAI 兼容客户端。messages 按顺序传入 system、user、assistant 等角色。
curl https://adminl.tools.ac.cn/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"YOUR_MODEL_ID","messages":[{"role":"user","content":"你好"}],"stream":false}'stream: false 返回完整 JSON,文本位于 choices[0].message.content;改为 true 后返回 SSE,增量文本位于 choices[0].delta.content,最后以 data: [DONE] 结束。常用参数包括 max_tokens 或 max_completion_tokens、temperature、top_p 和 tools。
Responses · POST /v1/responses
适用于 Codex、OpenAI Responses SDK 和支持 Responses 的客户端。最简单的请求使用字符串 input;多轮内容可以传入带 role 和 content 的输入项。
curl https://adminl.tools.ac.cn/v1/responses \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"YOUR_MODEL_ID","input":"你好","stream":false}'stream: false 返回 id、output、output_text 和 usage;stream: true 返回 SSE,文本增量事件为 response.output_text.delta,完成事件为 response.completed。Responses 优先使用原生 Responses 路由;没有原生路由时,网关会兼容同渠道的 Chat Completions 路由。previous_response_id、conversation 等跨请求历史功能需要原生 Responses 路由。
Anthropic Messages · POST /v1/messages
适用于 Claude Code、Anthropic SDK 和 Messages 协议客户端。必须提供 max_tokens;系统提示词放在 system,对话内容放在 messages。
curl https://adminl.tools.ac.cn/v1/messages \
-H "x-api-key: YOUR_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{"model":"YOUR_MODEL_ID","max_tokens":1024,"messages":[{"role":"user","content":"你好"}],"stream":false}'stream: false 返回 content 数组和 usage;stream: true 返回 Anthropic SSE 事件,例如 content_block_delta 和 message_stop。Messages 请求可以使用 tools,但结构化输出、上下文管理和特殊内容块需要模型配置为原生 Messages 协议。
Responses 上下文压缩 · POST /v1/responses/compact
对支持“上下文压缩”能力的 Responses 模型请求压缩结果。该接口不支持流式返回,具体可压缩字段以模型和上游能力为准。
curl https://adminl.tools.ac.cn/v1/responses/compact \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"YOUR_MODEL_ID","input":"请压缩这段上下文"}'Messages Token 估算 · POST /v1/messages/count_tokens
估算 Messages 请求的输入 Token,仅返回估算值,不生成模型回复,也不会按模型输出 Token 计费。
curl https://adminl.tools.ac.cn/v1/messages/count_tokens \
-H "x-api-key: YOUR_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{"model":"YOUR_MODEL_ID","messages":[{"role":"user","content":"你好"}]}'成功返回 { input_tokens: 123 }。模型需要启用 Token 计数能力;估算值是中转侧兼容估算,不等同于所有上游供应商的原生 tokenizer 结果。
图片生成 · POST /v1/images/generations
只有配置了 Images 协议和图片生成能力的模型可以调用。n 支持 1–4,size 可使用 auto、1024x1024、1536x1024 或 1024x1536。
curl -X POST https://adminl.tools.ac.cn/v1/images/generations \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"YOUR_IMAGE_MODEL_ID","prompt":"一间安静的宋式茶室","size":"1024x1024","n":1}'成功返回 data 数组,每项通常包含 url 或 b64_json;图片按后台设置的单张价格结算。
协议支持以模型配置为准。Claude Code 手动配置 ANTHROPIC_BASE_URL 时填写网关根地址,不要重复添加 /v1;Codex CLI 直连需要 Responses 协议。
03 / 编辑器配置
进入控制台「API Key」,点击密钥旁的「使用 API Key」,选择客户端、终端类型与模型,复制生成的配置。Codex CLI 默认提供环境变量与用户目录下的 .codex/config.toml,也可切换到 auth.json 或写入配置。Claude Code 同时提供终端命令与用户级 settings.json。展开「操作步骤与检查命令」可查看安装、打开文件、合并配置与重启方法。也可点击独立的「导入 CC Switch」,打开本机导入确认窗口。地址与密钥可调用当前分组全部授权模型;页面列出当前客户端可用的模型,Claude Code 也可使用中转兼容的 GPT 等 Chat 模型,但这是兼容转换,部分 Anthropic 原生能力(如结构化输出、上下文管理和特殊内容块)需使用原生 Messages 模型。下拉框只设置默认启动模型,导入后可在客户端按模型标识切换,不会缩小密钥权限。Codex CLI 直连需要 Responses 协议;仅提供 Chat 或 Messages 的 Grok 等模型需启用 CC Switch 本地路由。本站当前 Codex 直连使用 HTTP / SSE,未提供 WebSocket 传输。
在支持自定义提供商的客户端中填写服务地址和 API Key,模型选择对应标识。各客户端的配置入口不同,请以客户端当前配置说明为准。
密钥按渠道分组限定范围,可在同一分组内自由切换启用模型;后台新增模型后自动可用。更换分组时,请创建对应分组的 Key。
04 / 计费与安全
销售价格以人民币 / 每百万 Token 展示。缓存读取、5 分钟缓存写入与 1 小时缓存写入分别定价;生图端点沿用中转请求审计;图片模型在后台配置生图单张销售价后按张结算,失败请求自动释放预扣且不会写入资产库。
官网新密钥加密保存,所属用户登录后可查看;旧密钥可在详情粘贴原值校验保存。不要把密钥放在浏览器公开代码或提交到代码仓库。泄露后在控制台立即撤销。
THE NEXT CHAPTER IS YOURS.
