AllAI 使用教程

在线地址：https://app.allai.tv
一个 OpenAI 兼容的大模型 API 服务，底层由 ALLAI Bedrock（Claude 系列）驱动。
你可以在网页后台管理账户与密钥，并用 API Key 在自己的程序里调用模型。
💬 充值 / 咨询请联系管理员 QQ：2873535616

1. 快速开始

三步即可调用模型：

1. 打开 https://app.allai.tv，用账号登录。
2. 进入「API Key」页，点「创建」，复制生成的密钥（形如 sk-allai-xxxxxxxx，只显示一次）。
3. 在你的程序里用这个密钥调用接口：

curl https://api.allai.tv/v1/chat/completions \
  -H "Authorization: Bearer sk-allai-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "messages": [{"role": "user", "content": "你好，请做个自我介绍"}]
  }'

2. 登录后台

1. 访问 https://app.allai.tv。
2. 输入用户名与密码登录。
3. 登录后进入控制台，左侧为导航菜单。

🔐 全站走 HTTPS 加密，登录态有效期约 7 天，过期后需重新登录。

3. 控制台功能说明

登录后左侧菜单包含以下页面：

💲 金额单位为 美元 (USD)。
🕐 界面所有时间均按 北京时间 显示。

4. 创建并管理 API Key

创建

1. 进入「API Key」页，点击「创建」。
2. 填写一个便于识别的名称（如 我的测试、生产环境）。
3. 提交后会弹出完整密钥（如 sk-allai-38c522fb...）。

⚠️ 密钥只在创建时完整显示一次，请立刻复制保存到安全的地方。
列表里只会显示脱敏形式（如 sk-allai-38c...05b8），无法再次查看完整值。

使用

把密钥放进请求头：Authorization: Bearer sk-allai-你的密钥。

删除

在列表中点对应密钥的「删除」即可。删除后该密钥立即失效，用它发的请求会返回 401。

安全建议

• 不要把密钥写进前端代码、提交到 Git 仓库或公开分享。
• 一个用途用一个密钥，方便单独吊销。
• 怀疑泄露时，立即删除旧密钥并重建。

5. 网页对话测试台

不想写代码也能先试试模型效果。登录后进入左侧「对话测试台」：

1. 在顶部选择模型（下拉里会显示每个模型的名称与价格）。
2. （可选）填写系统提示、调整 max_tokens。
3. 在底部输入框输入消息，Enter 发送（Shift+Enter 换行）。
4. 每条回复下方会显示本次消耗的 token 数与费用，右上角实时显示账户余额。

测试台用你的登录身份直接调用，和用 API Key 调用一样会真实计费（按 token 从余额扣除）。
适合用来确认模型效果、对比不同模型，再决定在代码里用哪个。

6. 调用 AI 接口

服务同时兼容 OpenAI 与 Anthropic 两套接口格式，大多数 SDK / 工具只要改一下地址和密钥就能直接用。

• 接口地址（Base URL）：https://api.allai.tv/v1
• 鉴权：Authorization: Bearer sk-allai-...（或 Anthropic 风格的 x-api-key: sk-allai-...）

💡 旧地址 https://app.allai.tv/v1 仍然可用，已配置的无需修改。但推荐用 api.allai.tv：它直连服务器、单次请求最长可等 10 分钟；app.allai.tv 经 CDN 代理，单次请求超过约 100 秒会被 CDN 掐断（报 524），跑长任务（如 Claude Code 复杂请求）时建议换过来。

• 端点：

- POST /v1/chat/completions —— OpenAI 兼容 - POST /v1/messages —— Anthropic 原生（供 claude 命令行工具） - GET /v1/models —— 模型列表

6.0 终端命令行快捷用法

本服务同时兼容两套主流协议，你的密钥两边通用，按习惯任选：

• Anthropic 协议（/v1/messages）—— 可直接用 Claude 官方命令行工具 claude（见方式一）。
• OpenAI 协议（/v1/chat/completions）—— 可用 curl、OpenAI 官方 SDK 及任何兼容工具（见方式二及之后）。

OpenAI 风格的两个标准环境变量（curl / OpenAI SDK 会用到，加进 ~/.zshrc / ~/.bashrc 长期生效）：

export OPENAI_API_KEY="sk-allai-你的密钥"
export OPENAI_BASE_URL="https://api.allai.tv/v1"

方式一：Claude 官方命令行工具 claude（推荐）

本服务已实现 Anthropic 原生接口，可直接用 Anthropic 官方的命令行工具 Claude Code（claude 命令）连接，把它当成自带的 AI 编程助手用。

安装（需 Node.js）：

npm install -g @anthropic-ai/claude-code

配置：设置三个环境变量（加进 ~/.zshrc / ~/.bashrc 长期生效）：

export ANTHROPIC_BASE_URL="https://api.allai.tv"
export ANTHROPIC_AUTH_TOKEN="sk-allai-你的密钥"
export ANTHROPIC_MODEL="claude-sonnet-5"
export ANTHROPIC_SMALL_FAST_MODEL="claude-haiku-4-5"

- ANTHROPIC_BASE_URL：指向本服务（注意是 https://api.allai.tv，不带 /v1，claude 会自动补）。
- ANTHROPIC_AUTH_TOKEN：你的密钥，会以 Authorization: Bearer 发送。
- ANTHROPIC_MODEL / ANTHROPIC_SMALL_FAST_MODEL：主模型与后台轻量任务模型，填本服务的模型别名。

使用：直接在终端运行 claude 进入交互式编程助手，或用 -p 单次提问：

claude                                  # 进入交互模式
claude -p "用一句话解释什么是闭包"        # 单次提问，直接打印回答

之后 claude 的对话、改代码等功能都会走本服务、按 token 从你的余额计费。

方式二：curl（标准 OpenAI 请求）

curl "$OPENAI_BASE_URL/chat/completions" \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "messages": [{"role": "user", "content": "你好，用一句话介绍你自己"}]
  }'

只取回复文字（需 jq，Mac 装：brew install jq）：

curl -s "$OPENAI_BASE_URL/chat/completions" \
  -H "Authorization: Bearer $OPENAI_API_KEY" -H "Content-Type: application/json" \
  -d '{"model":"claude-sonnet-5","messages":[{"role":"user","content":"用一句话解释量子计算"}]}' \
  | jq -r '.choices[0].message.content'

方式三：流式输出（打字机效果，和主流平台一致）

加上 "stream": true 即按 SSE 标准逐字返回（data: {...} 一行行）：

curl -s -N "$OPENAI_BASE_URL/chat/completions" \
  -H "Authorization: Bearer $OPENAI_API_KEY" -H "Content-Type: application/json" \
  -d '{"model":"claude-sonnet-5","messages":[{"role":"user","content":"写一首关于秋天的短诗"}],"stream":true}'

OpenAI 官方 Python SDK 的流式写法也原样可用：

from openai import OpenAI
client = OpenAI()  # 自动读取 OPENAI_API_KEY / OPENAI_BASE_URL
stream = client.chat.completions.create(
    model="claude-sonnet-5",
    messages=[{"role": "user", "content": "写一首关于秋天的短诗"}],
    stream=True,
)
for chunk in stream:
    print(chunk.choices[0].delta.content or "", end="", flush=True)

方式四：封装一个随手可用的 ai 命令

把下面这段加进 ~/.zshrc 或 ~/.bashrc，source 后即可在终端任意位置提问：

ai() {
  curl -s "$OPENAI_BASE_URL/chat/completions" \
    -H "Authorization: Bearer $OPENAI_API_KEY" -H "Content-Type: application/json" \
    -d "{\"model\":\"claude-sonnet-5\",\"messages\":[{\"role\":\"user\",\"content\":\"$*\"}]}" \
    | jq -r '.choices[0].message.content'
}
# 用法： ai 帮我写一句关于修复登录bug的git提交信息

Windows PowerShell

$env:OPENAI_API_KEY  = "sk-allai-你的密钥"
$env:OPENAI_BASE_URL = "https://api.allai.tv/v1"
$body = @{
  model    = "claude-sonnet-5"
  messages = @(@{ role = "user"; content = "你好，用一句话介绍你自己" })
} | ConvertTo-Json
$r = Invoke-RestMethod -Uri "$env:OPENAI_BASE_URL/chat/completions" `
  -Method Post -ContentType "application/json" `
  -Headers @{ Authorization = "Bearer $env:OPENAI_API_KEY" } -Body $body
$r.choices[0].message.content

💡 换模型：把 claude-sonnet-5 改成 claude-haiku-4-5（更快更省）或 claude-opus-4-8（旗舰，最强）。
⚠️ 选 claude-opus-4-8 时不要传 temperature 参数，否则会报错。

6.1 列出可用模型

curl https://api.allai.tv/v1/models \
  -H "Authorization: Bearer sk-allai-你的密钥"

返回每个模型的 id 和价格（每百万 token 的美元单价）。

6.2 对话补全（curl）

curl https://api.allai.tv/v1/chat/completions \
  -H "Authorization: Bearer sk-allai-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "messages": [
      {"role": "system", "content": "你是一个简洁的助手"},
      {"role": "user", "content": "用一句话解释什么是量子计算"}
    ],
    "max_tokens": 200
  }'

返回（节选）：

{
  "id": "chatcmpl-xxxx",
  "object": "chat.completion",
  "model": "claude-sonnet-5",
  "choices": [
    {
      "index": 0,
      "message": { "role": "assistant", "content": "量子计算是……" },
      "finish_reason": "stop"
    }
  ],
  "usage": { "prompt_tokens": 28, "completion_tokens": 60, "total_tokens": 88 }
}

6.3 Python（OpenAI 官方 SDK）

from openai import OpenAI

client = OpenAI(
    api_key="sk-allai-你的密钥",
    base_url="https://api.allai.tv/v1",
)

resp = client.chat.completions.create(
    model="claude-sonnet-5",
    messages=[
        {"role": "system", "content": "你是一个简洁的助手"},
        {"role": "user", "content": "你好"},
    ],
    max_tokens=200,
)
print(resp.choices[0].message.content)
print("用量:", resp.usage)

6.4 Python（不依赖 SDK，用 requests）

import requests

r = requests.post(
    "https://api.allai.tv/v1/chat/completions",
    headers={"Authorization": "Bearer sk-allai-你的密钥"},
    json={
        "model": "claude-haiku-4-5",
        "messages": [{"role": "user", "content": "讲个冷笑话"}],
    },
    timeout=120,
)
print(r.json()["choices"][0]["message"]["content"])

6.5 Node.js（OpenAI SDK）

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "sk-allai-你的密钥",
  baseURL: "https://api.allai.tv/v1",
});

const resp = await client.chat.completions.create({
  model: "claude-sonnet-5",
  messages: [{ role: "user", content: "你好" }],
});
console.log(resp.choices[0].message.content);

6.6 请求参数说明

system 角色的消息会被合并为系统提示；至少需要一条 user 消息。
流式与非流式计费方式相同（都按实际 token 数扣费）。

6.7 图片解析（看图 / 多模态）

支持让模型「看图」：在 user 消息的 content 里用数组形式，混合文本块与图片块（OpenAI 标准格式）。GPT-5.5 / 5.4 与 Claude 系列均支持。

图片可以用两种方式给出：

• base64 内联（推荐，最稳）："url": "data:image/png;base64,<base64数据>"
• 图片链接："url": "https://example.com/cat.jpg"（本服务会替你下载该图再转给模型，单张上限 10MB）

# 以 base64 内联为例（PNG 同理把 jpeg 换成 png）
IMG_B64=$(base64 -i cat.jpg)   # Mac；Linux 用 base64 -w0 cat.jpg
curl -s https://api.allai.tv/v1/chat/completions \
  -H "Authorization: Bearer sk-allai-你的密钥" -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "messages": [{
      "role": "user",
      "content": [
        {"type": "text", "text": "这张图里有什么？用中文描述。"},
        {"type": "image_url", "image_url": {"url": "data:image/jpeg;base64,'"$IMG_B64"'"}}
      ]
    }]
  }'

Python（OpenAI SDK）写法：

import base64
from openai import OpenAI
client = OpenAI(api_key="sk-allai-你的密钥", base_url="https://api.allai.tv/v1")

b64 = base64.b64encode(open("cat.jpg", "rb").read()).decode()
resp = client.chat.completions.create(
    model="gpt-5.5",  # 或 claude-sonnet-5
    messages=[{"role": "user", "content": [
        {"type": "text", "text": "这张图里有什么？"},
        {"type": "image_url", "image_url": {"url": f"data:image/jpeg;base64,{b64}"}},
    ]}],
)
print(resp.choices[0].message.content)

支持的图片格式：PNG / JPEG / GIF / WebP。一条消息可放多张图（多加几个 image_url 块）。

7. 在编辑器中使用

本服务兼容 OpenAI 接口，凡是支持「自定义 OpenAI 接口地址」的工具/插件都能接入。

通用三要素（任何工具都填这三项）：

⚠️ 选 claude-opus-4-8 时，部分插件会默认带 temperature，可能报错；遇到报错就换 Sonnet/Haiku，或在插件里关掉 temperature。

JetBrains 用户看这里：JetBrains 系列 IDE（IntelliJ IDEA / PyCharm / WebStorm / GoLand / RubyMine 等）自带的 AI Assistant 绑定 JetBrains 官方账号、不支持填第三方 API 端点，没法直连本服务。要在 JetBrains 里用上 AllAI，请装下面的 Continue（7.1，最简单，推荐）或 ProxyAI（7.2，功能更全），二选一即可。

7.1 Continue（VS Code / JetBrains 通用，推荐）

Continue 同时有 VS Code 和 JetBrains 两个版本，两者读同一份配置文件，配置一次到处通用。下面以 JetBrains 为主，VS Code 步骤几乎一致（差别只在装插件的入口）。

第 1 步：安装插件

• JetBrains：菜单 File → Settings（macOS 是 IntelliJ IDEA → Preferences，快捷键 ⌘,）→ 左侧选 Plugins → 顶部切到 Marketplace 标签 → 搜索框输入 Continue → 点 Install → 装完点 Restart IDE 重启。重启后窗口右侧边栏会多出一个 Continue 图标。
• VS Code：左侧扩展面板（⌘⇧X）搜索 Continue → Install。

第 2 步：打开配置文件

Continue 的配置文件统一在用户主目录下：~/.continue/config.yaml（Windows 是 C:\Users\你的用户名\.continue\config.yaml）。

• 打开方式一：点右侧 Continue 侧栏 → 底部/右上角的齿轮 ⚙️ 设置图标 → 选 Open config file，IDE 会直接打开这个文件。
• 打开方式二：用任意编辑器手动打开上面那个路径（首次使用若文件不存在，先在 Continue 面板里点一下设置，它会自动创建）。

第 3 步：填入 AllAI 配置

把文件内容替换成下面这段（已有内容可整体覆盖），把 sk-allai-你的密钥 换成你自己的 Key：

name: AllAI
version: 1.0.0
schema: v1
models:
  - name: AllAI Claude Sonnet 5      # 侧栏下拉里显示的名字，随便起
    provider: openai                   # 固定填 openai（本服务是 OpenAI 兼容接口）
    model: claude-sonnet-5           # 模型别名，编程推荐 Sonnet
    apiBase: https://api.allai.tv/v1   # 注意结尾带 /v1
    apiKey: sk-allai-你的密钥           # 换成你的密钥
    roles:
      - chat        # 对话
      - edit        # 选中代码让它改
      - apply       # 把改动应用回文件
  - name: AllAI Claude Haiku 4.5       # 再加一个更省钱的模型（可选）
    provider: openai
    model: claude-haiku-4-5
    apiBase: https://api.allai.tv/v1
    apiKey: sk-allai-你的密钥
    roles:
      - chat
      - edit
      - apply

⚠️ YAML 对缩进敏感：每级用 2 个空格，不要用 Tab；- 后面要有一个空格。照着上面复制最稳妥。

第 4 步：开始使用

1. 保存配置文件（⌘S）。Continue 会自动重新加载，无需重启。
2. 打开右侧 Continue 侧栏，在输入框上方的模型下拉里选「AllAI Claude Sonnet 5」。
3. 直接在输入框提问即可对话；想改代码就在编辑器里选中一段代码，按 ⌘I（Windows Ctrl+I）输入要求，让它就地改写。
4. 之后所有对话、改代码都会走本服务、按 token 从你的余额计费。

想加更多模型，照着上面复制一段 - name: ... 改 model 即可。

7.2 ProxyAI（JetBrains 编程插件，功能更全，原 CodeGPT）

ProxyAI 是 JetBrains 插件市场里最流行的编程 AI 插件（原名 CodeGPT），除了对话、改代码，还支持代码自动补全。配置比 Continue 稍繁（要填完整 URL），但功能更全。

第 1 步：安装插件

菜单 File → Settings（macOS ⌘,）→ Plugins → Marketplace → 搜索 ProxyAI（搜 CodeGPT 也能找到）→ Install → Restart IDE。

第 2 步：添加 AllAI 为自定义服务

1. 重启后再进 File → Settings → 左侧展开 Tools → 选 ProxyAI → 子项 Providers。
2. 在 Provider 列表里选 Custom OpenAI（自定义 OpenAI 兼容服务）。
3. 右侧 Name 处给它起个名，比如 AllAI。
4. 找到 URL 字段，填完整的对话补全地址（注意：这里不是只填 base url，要带上 /chat/completions）：

`` https://api.allai.tv/v1/chat/completions ``

1. API key：填你的 sk-allai-你的密钥。ProxyAI 会以 Authorization: Bearer <你的key> 发送（这是默认的 Headers，一般不用改）。
2. 在 Body 区（或 Edit JSON）里确认/填入模型名，把 model 设为别名：

``json { "model": "claude-sonnet-5" } ``

编程推荐 claude-sonnet-5；想省钱用 claude-haiku-4-5。

第 3 步：测试并保存

点界面上的 Test Connection（测试连接），看到成功提示后，点 Apply → OK 保存。

第 4 步：使用

• 对话/改代码：打开右侧 ProxyAI 侧栏直接提问；选中代码右键 → ProxyAI 里的改写/解释等操作。
• 代码补全（可选）：在 Settings → Tools → ProxyAI → Code Completion 里勾选 Enable code completion，并把补全用的 provider 也选成刚配置的 AllAI，写代码时即可获得行内自动补全。
• 所有功能都走本服务、按 token 从余额计费。

常见问题

• 报 401 / Unauthorized：Key 填错或前后有空格；确认是 sk-allai- 开头的有效 Key。
• 报 404 / 找不到接口：URL 漏了 /chat/completions，或写成了 api.allai.tv（少了 https://）。
• 选 claude-opus-4-8 报 temperature 相关错误：换成 Sonnet/Haiku，或在 Body 里删掉 temperature 字段（见本章开头的提示）。

7.3 Cline / Roo Code（VS Code 编程插件）

1. 在扩展市场安装 Cline（或 Roo Code）。
2. 打开插件设置，API Provider 选 「OpenAI Compatible」。
3. 按如下填写：

- Base URL：https://api.allai.tv/v1 - API Key：sk-allai-你的密钥 - Model ID：claude-sonnet-5（编程建议用 Sonnet）

1. 保存即可开始用。Cline 会发起多轮长对话，注意余额消耗。

7.4 其他工具

任何支持自定义 OpenAI 端点的工具同理（如 Cursor 的「Override OpenAI Base URL」、各类 Chat 客户端、LangChain、LlamaIndex 等）：把 base url 指向 https://api.allai.tv/v1、key 用 sk-allai-...、模型名用上面的别名即可。

8. 可用模型与价格

通过 GET /v1/models 可获取实时清单。当前支持：

也可以直接传完整的 ALLAI Bedrock 模型 ID（透传）；未在上表的模型按默认单价计费。
⚠️ 调 claude-opus-4-8 时不要传 temperature，否则会报错。
关于 GPT-5.5 / 5.4：它们是 OpenAI 推理模型，会先做一段内部推理再给出回答，推理消耗的 token 也计入输出 token 计费。
- 用法和别的模型一样："model": "gpt-5.5"。对话 / 流式都支持。
- 支持图片解析（看图）：在 content 里用 OpenAI 标准的 image_url 块即可（见 6.7）。Claude 系列同样支持看图。
- 暂不支持工具调用（function calling / tool use），即用在 Claude Code、Cline 等需要"自己改文件"的 agent 里时不会动手改代码；纯对话、问答、写代码片段则正常。需要 agent 改文件请用 Claude 系列。
- 由于是推理模型，建议 max_tokens 不要设太小（服务端已自动保证最低输出预算）。

9. 计费说明

• 计费单位为 美元 (USD)，每次调用按 输入 + 输出 token 数 × 模型单价 实时从账户余额扣除。
• 每次调用都会记录在「使用记录」页，包含模型、输入/输出/总 token、费用、时间。
• 「仪表盘」实时展示余额与今日用量（数据有约 30 秒缓存，可能略有延迟）。
• 余额 ≤ 0 时无法继续调用，接口会返回 insufficient_balance 错误，请联系管理员充值。
• 费用精确到很小的小数位（如 $0.0005），界面余额显示 4 位小数。

购买 / 充值（联系管理员）

普通用户余额由管理员充值。购买 token / 充值请联系管理员 QQ：

💬 管理员 QQ：2873535616

联系时向管理员说明你的账号用户名与充值金额即可；也可咨询使用问题、反馈 bug。 （管理员侧：登录后进入「用户管理」，找到对应用户点「充值」，输入金额（USD）。）

10. 常见问题 FAQ

Q：我能在 OpenAI 的官方库 / LangChain / 各类客户端里直接用吗？ A：能。把 base_url（或 OPENAI_BASE_URL）设为 https://api.allai.tv/v1，api_key 设为你的 sk-allai-... 即可。

Q：密钥忘了 / 没复制怎么办？ A：密钥不可找回，只能删除旧的、重新创建一个。

Q：返回内容被截断了？ A：调大 max_tokens。

Q：调用很慢 / 超时？ A：大模型生成需要时间，服务端最长等待约 10 分钟。请把客户端超时设大一些（建议 ≥ 120 秒）。

Q：报 524（Cloudflare timeout）？ A：你用的是旧地址 app.allai.tv——它经 CDN 代理，非流式长请求超过约 100 秒会被 CDN 掐断。把 Base URL 换成 https://api.allai.tv（直连，最长可等 10 分钟）即可解决，密钥不变。

Q：返回报 temperature is deprecated？ A：你用的模型（如 Opus 4.8）不接受 temperature 参数，去掉该字段重发即可。

Q：时间为什么和我电脑显示的不一样？ A：后台界面统一显示北京时间。

Q：调用一次扣了多少钱？ A：看「使用记录」对应那条的「费用 (USD)」列，或看接口返回的 usage 字段自行按价格表计算。

11. 错误码对照

接口出错时返回 OpenAI 风格的错误结构：

{ "error": { "message": "……", "type": "invalid_request_error", "code": "xxx" } }

如需更多帮助，请联系系统管理员。