HHCLAW A12 使用文档

📑 目录

1. 积分计费规则
2. 如何添加自己的API
3. 支持的API提供商
4. 中转API是什么？怎么用？
5. 卡密充值说明
6. 常见问题

💰 A12 全新计费方式

从 A12 版本开始，HHCLAW 采用按字数计费的方式，规则非常简单：

📊 积分价格对照

📝 方法一：在APP内添加（推荐）

1. 打开 HHCLAW APP
2. 点击底部导航栏的 「设置」
3. 找到 「AI 配置」区域
4. 点击 「添加AI配置」按钮
5. 选择提供商（如 OpenAI、DeepSeek 等），或选择 「自定义」
6. 填写以下信息：
   • 名称：给你这个API起个名字（如"我的GPT-4o"）
   • API地址：填写 Base URL（如 https://api.openai.com/v1）
   • API密钥：你的 API Key（如 sk-xxxxx）
   • 模型ID：要使用的模型名（如 gpt-4o）
7. 点击 「扫描模型」可以自动获取该API支持的所有模型列表
8. 点击 「测试」按钮验证连接是否正常
9. 保存后，在 AI 对话页面的下拉菜单中选择你添加的模型即可使用

📝 方法二：通过中转API管理添加

1. 打开 HHCLAW APP
2. 点击底部导航栏的 「API」
3. 在 「API 管理中心」中点击 「添加 API」
4. 选择提供商或自定义，填写 API 信息
5. 可以在这里 开关中转服务，把你的API分享给其他设备使用

📝 方法三：直接编辑配置文件（开源版 AP1）

如果你使用的是开源版 AP1，可以直接编辑 app/src/main/assets/api_config.json：

{
  "ai_providers": [
    {
      "id": "my-api",
      "name": "我的API",
      "base_url": "https://api.example.com/v1",
      "api_key": "sk-your-key-here",
      "model": "gpt-4o",
      "provider": "openai",
      "enabled": true
    }
  ]
}

将 enabled 设为 true，填入你的 API 信息，重新编译即可。

HHCLAW 内置了以下主流 AI 提供商的预配置，添加时只需填入 API Key：

🔄 什么是中转API？

中转API（Relay API）是一个非常强大的功能，它可以让你的手机变成一个 API 服务器。

简单来说：

• 你在 HHCLAW 中配置了一个或多个 AI API（如 OpenAI、DeepSeek 等）
• 开启「中转服务」后，你的手机会启动一个 HTTP 服务器
• 其他设备（电脑、另一部手机、平板等）可以通过网络访问你手机的 IP 地址来调用这些 API
• 你配置的 API 密钥不需要暴露给其他设备，它们只需要连接你的手机即可

🚀 中转API能做什么？

1. 统一入口：你配置了多个AI（OpenAI、DeepSeek、Claude等），中转服务提供一个统一的地址，其他应用只需要对接一个接口
2. 密钥保护：API Key 只存在你的手机上，其他设备不需要知道密钥
3. 局域网共享：在家里或办公室，一台手机配置好，所有设备都能用
4. 开发调试：开发 OpenAI 兼容应用时，可以直接用中转地址测试
5. 跨平台调用：电脑上的 Python 脚本、浏览器插件、其他 APP 都可以通过标准 OpenAI API 格式调用

📖 如何使用中转API

1. 打开 HHCLAW → 底部导航「API」
2. 在 API 管理中心添加你想要的 AI API（添加方法见上方第二节）
3. 在 API 列表中，打开你想中转的 API 右侧的 「中转」开关
4. 点击 「启动」按钮启动中转服务器
5. 启动后会显示中转地址，格式为：

   POST http://你的手机IP:8318/v1/chat/completions
   GET  http://你的手机IP:8318/v1/models
   GET  http://你的手机IP:8318/health

6. 其他设备使用标准 OpenAI API 格式调用即可

💡 调用示例

Python 调用示例：

import openai

client = openai.OpenAI(
    base_url="http://192.168.1.100:8318/v1",
    api_key="any-key"  # 中转不需要真实key
)

response = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "你好"}]
)
print(response.choices[0].message.content)

curl 调用示例：

curl http://192.168.1.100:8318/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [{"role": "user", "content": "你好"}],
    "stream": false
  }'

🔑 什么是卡密？

卡密（卡号密码）是一串唯一编码，用来兑换积分。购买卡密后，在APP或官网输入即可获得对应积分。

🛒 如何购买？

1. 在 APP 中点击「充值」→「购买卡密」，跳转到商城
2. 或直接访问：https://ai.fk.8l.pw/
3. 选择套餐，完成支付后获得卡密

🔑 如何兑换？

• APP内兑换：点击「充值」→「输入卡密兑换积分」→ 输入卡密 → 兑换成功
• 官网兑换：登录 r.hx12.top/user.html → 在卡密兑换区域输入 → 兑换

💳 卡密套餐

Q：添加API后测试失败怎么办？

A：检查以下几点：

• API地址是否正确（只需到 /v1）
• API Key 是否正确（注意前后不要有空格）
• 网络是否能访问该API（部分API需要科学上网）
• 该API账户是否有余额

Q：免费模型和付费模型有什么区别？

A：

• 免费模型（GPT-3.5-turbo）：每日 5 次，不需要积分，通过服务端代理调用
• 付费模型（mimo-v2.5）：消耗积分，每200字100积分，直接调用AI接口
• 自定义模型：你自己添加的API，直接调用你配置的端点，不消耗积分（但你的API账户可能有费用）

Q：中转服务启动失败？

A：可能原因：

• 端口被占用：尝试修改端口号
• 没有启用中转的API：至少需要在API列表中打开一个API的「中转」开关
• 防火墙拦截：检查手机的网络设置

Q：自定义模型调用不消耗积分？

A：是的。自定义模型是你自己配置的API，直接连接你指定的端点，不经过服务端代理，所以不消耗积分。但你的API账户可能会产生费用（取决于你使用的API服务商）。

Q：工作组中的AI可以使用自定义模型吗？

A：可以。在工作组中 @AI成员 时，会使用当前选中的模型。你可以在对话页面切换到自定义模型，工作组中的AI也会使用该模型。