AKASHICLLM FOR INDEPENDENT MINDS
CONNECT ON YOUR TERMS

接入文档

填写 API 地址、Key 和模型 ID,接入你的客户端或脚本。

更新日期 · 2026-11-21

这是 Akashic LLM 本站的接入说明。当前平台仍为预览版,尚未接入真实模型渠道。以下示例中的 API Key 和模型 ID 都需要换成你账户实际可用的值。

接入地址

配置项填写内容
Base URLhttps://akashic.doge420.com/v1
API Key在本站控制台创建的客户 API 令牌
模型 ID你账户实际有权限使用、且已上架的模型 ID
鉴权头Authorization: Bearer YOUR_API_KEY

在 OpenAI 兼容客户端中添加自定义供应商,填写以上地址与令牌。不要将管理员登录密码当作 API Key,也不要将令牌放入公开网页、仓库或截图。

获取令牌与选择模型

  1. 登录控制台。没有账户时可先注册账户。新用户初始额度为 0,实际调用前需具备可用余额和模型权限。
  2. 在令牌管理中创建 API Key,按需设置有效期、额度、模型及其他可用限制。
  3. 查看账户的可用模型和余额。模型名称应使用准确的模型 ID。
  4. 在客户端填写 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 规则。

使用与责任

调用前请阅读免责声明与使用条款。自行验证模型生成的事实、代码与指令。安全研究和渗透测试需要确认目标授权与范围,账户和模型回答不能替代合法授权。