5 分钟接入

准备账号、创建 API Key，然后用 cURL、Python 或 Node.js 发出请求。

1. 登录并创建密钥#

通过站点登录页进入控制台。注册是否开放、是否需要邀请码以及可用的登录方式由管理员配置。已有 Telegram 绑定令牌时，也可在 Bot 中执行 /bind <绑定令牌>；使用邀请码注册可执行 /register <邀请码>。

打开「API 密钥」，创建允许 chat 能力的密钥，并确认允许的模型。创建、重置、轮换时保存新密钥；有权限的拥有者也可使用控制台的明文查询功能。业务服务应从环境变量或密钥管理系统读取密钥。

2. 配置地址与公开模型#

环境变量

export OPENAI_API_KEY="sk_your_gateway_key"
export OPENAI_BASE_URL="https://www.ackddos.store/v1"
export GATEWAY_MODEL="your-public-model"

查询可用模型

curl "$OPENAI_BASE_URL/models" \
  -H "Authorization: Bearer $OPENAI_API_KEY"

把 GATEWAY_MODEL 换成模型列表中的 id。SDK 的 Base URL 包含 /v1；手写 HTTP 请求则使用完整端点。不要在地址末尾重复拼接 /v1。

3. 发出第一条请求#

对话请求

curl "https://www.ackddos.store/v1/chat/completions" \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-public-model",
    "messages": [{"role": "user", "content": "你好，介绍一下你自己。"}],
    "max_tokens": 256
  }'

示例中的 your-public-model 需要手动替换。模型存在但请求仍被拒绝时，依次检查密钥 scope、模型白名单、IP 策略、套餐状态、余额与配额。

打开 API 密钥管理调用权限与访问限额。使用 Playground在控制台验证模型与流式输出。