更新日期 · 2026-11-21
这是 Akashic LLM 本站的接入说明。当前平台仍为预览版,尚未接入真实模型渠道。以下示例中的 API Key 和模型 ID 都需要换成你账户实际可用的值。
接入地址
| 配置项 | 填写内容 |
|---|---|
| Base URL | https://akashic.doge420.com/v1 |
| API Key | 在本站控制台创建的客户 API 令牌 |
| 模型 ID | 你账户实际有权限使用、且已上架的模型 ID |
| 鉴权头 | Authorization: Bearer YOUR_API_KEY |
在 OpenAI 兼容客户端中添加自定义供应商,填写以上地址与令牌。不要将管理员登录密码当作 API Key,也不要将令牌放入公开网页、仓库或截图。
获取令牌与选择模型
- 登录控制台。没有账户时可先注册账户。新用户初始额度为 0,实际调用前需具备可用余额和模型权限。
- 在令牌管理中创建 API Key,按需设置有效期、额度、模型及其他可用限制。
- 查看账户的可用模型和余额。模型名称应使用准确的模型 ID。
- 在客户端填写 Base URL、Key 和模型 ID,先进行一次小请求测试。
查询可用模型
export AKASHIC_API_KEY='替换为你的客户API令牌'
curl https://akashic.doge420.com/v1/models \
-H "Authorization: Bearer $AKASHIC_API_KEY"
返回列表由账户权限、令牌限制和实际已配置的模型决定。空列表或模型不可用时,请联系站点管理员确认渠道与账户配置。
发起一次对话
curl https://akashic.doge420.com/v1/chat/completions \
-H "Authorization: Bearer $AKASHIC_API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"model": "YOUR_AVAILABLE_MODEL_ID",
"messages": [
{"role": "user", "content": "请简要解释零信任架构。"}
],
"max_tokens": 128,
"stream": false
}'
将 YOUR_AVAILABLE_MODEL_ID 换成真实可用模型。需要流式响应时,将 stream 设为 true;使用 curl 可加 -N 关闭客户端输出缓冲。
使用兼容 SDK
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["AKASHIC_API_KEY"],
base_url="https://akashic.doge420.com/v1",
)
response = client.chat.completions.create(
model="YOUR_AVAILABLE_MODEL_ID",
messages=[{"role": "user", "content": "解释一下 TLS 握手。"}],
max_tokens=128,
)
print(response.choices[0].message.content)
不同模型对工具调用、结构化输出、推理参数和其他协议能力的支持可能不同。请按具体模型说明配置,不要把“兼容接口”理解为支持全部厂商功能。
常见问题
| 现象 | 排查方向 |
|---|---|
| 401 / 无效令牌 | 检查是否使用本站客户 Key、Bearer 格式、过期状态及限制。 |
| 额度不足 | 检查账户余额和令牌自身额度;两者都需要满足请求条件。 |
| 模型不可用 / 503 | 确认模型 ID、账户分组、渠道状态;新渠道配置同步可能需要几秒。 |
| 429 / 请求受限 | 按响应提示降低请求频率与并发。流式已输出内容后,不要盲目重试整个请求。 |
| Cloudflare 403 / 1010 | 当前预览存在边缘规则兼容性限制,部分脚本客户端可能被拦截。请向管理员报告客户端信息,由管理员检查 API 路径的 Cloudflare 规则。 |
使用与责任
调用前请阅读免责声明与使用条款。自行验证模型生成的事实、代码与指令。安全研究和渗透测试需要确认目标授权与范围,账户和模型回答不能替代合法授权。