💡 将此 Key 填入你的 Agent 配置中即可上报数据。详见 接入指南

选择不同的 AI 编程 Agent，系统自动估算月度使用成本，帮助你选择最具性价比的工具。

面向开发者：将你的 AI Agent 接入虾算账成本监控平台

1. 概述

虾算账是一个 AI 成本监控平台，帮助开发者追踪 AI Agent 调用大模型时产生的 Token 用量与成本。接入后，你可以在虾算账平台可视化地查看每次调用的成本明细、按模型/项目维度聚合的用量统计。

工作原理

接入架构分为两层：

1. 模型调用层：你的 Agent（如 OpenClaw）通过 OpenAI 兼容接口调用大模型。通过将 base_url 指向虾算账提供的接入端点，所有模型请求都会经过该端点。
2. 成本上报层：虾算账的接入端点（report 云函数）负责接收每次调用的 Token 用量，按统一计价规则计算成本，并记录到你在虾算账平台的项目下。

统一计价规则：每 1000 Tokens 成本为 ¥0.002。

┌─────────────┐      1.调用模型       ┌────────────────────┐
│  你的 Agent │ ───────────────────▶ │   虾算账接入端点    │
│  (OpenClaw) │                      │  (report 云函数)    │
└─────────────┘                      └─────────┬──────────┘
                                               │ 2.记录用量与成本
                                               ▼
                                   ┌──────────────────────┐
                                   │  虾算账平台（可视化面板）│
                                   └──────────────────────┘

接入端点信息

在配置 Agent 之前，请先完成以下准备：

步骤 1：访问虾算账平台

打开虾算账平台即可自动完成匿名登录，无需注册。

步骤 2：创建项目并获取 API Key

1. 进入「项目管理」页面，点击「创建项目」。
2. 填写项目名称（如 my-openclaw-agent），完成创建。
3. 进入项目详情页，在 API Key 区域点击复制按钮获取 Key。
4. 复制生成的 API Key（格式形如 xsz_xxxxxxxxxxxxxxxxxxxx），妥善保存。

步骤 3：确认你的 Agent 已安装

本指南以 OpenClaw（龙虾 AI）为例。确认你已按 OpenClaw 官方文档 完成安装，并能找到配置文件 config.yaml（默认位于项目根目录或 ~/.openclaw/config.yaml）。

OpenClaw 通过 config.yaml 管理模型供应商配置。接入虾算账只需修改两处：将 base_url 指向我们的接入端点，将 api_key 替换为你在虾算账平台获取的 API Key。

3.1 修改 config.yaml

打开你的 config.yaml，找到 models 配置段，按下方示例修改：

# ============================================================
# 虾算账接入配置示例
# 适用于 OpenClaw（龙虾 AI）
#
# 使用前请：
# 1. 在虾算账平台创建项目并获取 API Key
# 2. 将 API Key 通过环境变量注入（见下方 XIAYSZ_API_KEY）
# 3. 将本文件内容合并到你的 config.yaml 中
# ============================================================

# ── 模型供应商配置 ──
models:
  xiaysz:
    # 虾算账接入端点（请勿修改）
    base_url: "https://1307997565-3t7c0r8178.ap-beijing.tencentscf.com"
    # 在虾算账平台获取的 API Key，通过环境变量注入
    api_key: "${XIAYSZ_API_KEY}"
    # 默认模型，按实际使用的模型填写
    default_model: "gpt-4o"

# ── Agent 配置 ──
agents:
  my-agent:
    # 使用 xiaysz 供应商，格式为 <provider>/<model>
    model: "xiaysz/gpt-4o"

# ============================================================
# 环境变量设置（任选其一，二选一即可）
#
# Linux / macOS:
#   export XIAYSZ_API_KEY="xsz_你的实际APIKey"
#
# Windows (PowerShell):
#   $env:XIAYSZ_API_KEY = "xsz_你的实际APIKey"
#
# Windows (CMD):
#   set XIAYSZ_API_KEY=xsz_你的实际APIKey
# ============================================================

3.2 通过环境变量注入 API Key（推荐）

为避免将密钥明文写入配置文件，建议使用环境变量：

Linux / macOS：

export XIAYSZ_API_KEY="xsz_你的实际APIKey"

Windows (PowerShell)：

$env:XIAYSZ_API_KEY = "xsz_你的实际APIKey"

OpenClaw 在解析配置时会自动替换 ${XIAYSZ_API_KEY} 为对应的环境变量值。

3.3 验证配置文件语法

修改完成后，运行以下命令校验配置：

openclaw config validate

若输出 Config is valid 即表示配置文件语法正确。若报错，常见原因：

• YAML 缩进不一致（请统一使用空格，不要混用 Tab）
• ${ENV_VAR} 环境变量未设置

完成配置后，请按以下步骤确认接入成功。

4.1 执行一次简单对话

在 OpenClaw 中发起一次简单的对话调用：

openclaw chat "你好，请用一句话介绍你自己"

正常情况下，你会收到模型返回的响应。这表示请求已成功经过虾算账接入端点。

4.2 直接调用接入端点验证（可选）

如需单独验证接入端点本身是否正常工作，可使用 curl 手动发送一次上报请求：

curl -X POST "https://1307997565-3t7c0r8178.ap-beijing.tencentscf.com" \
  -H "Content-Type: application/json" \
  -d '{
    "apiKey": "xsz_你的实际APIKey",
    "model": "gpt-4o",
    "inputTokens": 800,
    "outputTokens": 400
  }'

预期返回：

{"code":0,"message":"上报成功","data":{"cost":0.0024,"totalTokens":1200}}

4.3 在虾算账平台查看上报记录

1. 登录虾算账平台，进入你的项目。
2. 切换到「调用记录」或「用量明细」页面。
3. 确认能看到刚才那次调用对应的记录：

• 模型：gpt-4o
• 输入 Tokens：800
• 输出 Tokens：400
• 总 Tokens：1200
• 成本：¥0.0024

请求参数

传输方式

• POST（推荐）：将参数以 JSON 格式放在请求体，Header 设置 Content-Type: application/json
• GET：将参数作为 URL Query 传递，如 ?apiKey=xxx&model=gpt-4o&inputTokens=800&outputTokens=400

成功返回

{
  "code": 0,
  "message": "上报成功",
  "data": {
    "cost": 0.0024,
    "totalTokens": 1200
  }
}

失败返回

{
  "code": 400,
  "message": "缺少 apiKey"
}

常见错误码：400（参数缺失）、401（鉴权失败，规划中）。

成本计算公式

totalTokens = inputTokens + outputTokens
cost        = (totalTokens / 1000) × 0.002   (单位：元)

虾算账接入端点兼容标准 HTTP 请求，任何支持自定义 base_url 的 Agent 框架均可接入。通用接入步骤：

1. 在 Agent 配置中找到模型供应商（Provider）设置项。
2. 将 API 端点（base_url / baseURL）替换为：https://1307997565-3t7c0r8178.ap-beijing.tencentscf.com
3. 将 API Key 替换为虾算账平台获取的 API Key。
4. 发起一次调用，到虾算账平台确认上报记录。

如需针对特定框架（如 LangChain、AutoGen、CrewAI 等）的配置指引，请参考对应框架文档或联系虾算账支持。

🐍 Python SDK 接入教程

1. 安装 SDK

# 在线安装（推荐）
                        pip install https://xiasuanzhang.cn/sdk/costlens-0.1.0-py3-none-any.whl

                        # 验证安装
                        python -c "from costlens import CostLens; print('✅ 安装成功')"

2. 获取 API Key

访问 xiasuanzhang.cn → 项目管理 → 创建项目 → 复制 xsz_ 开头的 API Key

3. 快速开始（3 行代码）

from costlens import CostLens

                        cl = CostLens(api_key="xsz_你的项目Key")
                        result = cl.report(model="gpt-4o", input_tokens=1000, output_tokens=200)
                        print(result)
                        # 输出：{'success': True, 'cost': 0.0024, 'total_tokens': 1200, 'message': '上报成功'}

4. 在 OpenAI 调用中上报

import openai
                        from costlens import CostLens

                        cl = CostLens(api_key="xsz_xxx")

                        response = openai.ChatCompletion.create(
                            model="gpt-4o",
                            messages=[{"role": "user", "content": "Hello"}]
                        )

                        cl.report(
                            model="gpt-4o",
                            input_tokens=response.usage.prompt_tokens,
                            output_tokens=response.usage.completion_tokens
                        )

5. 上下文管理器用法

with CostLens(api_key="xsz_xxx") as cl:
                            cl.report(model="gpt-4o", input_tokens=1000, output_tokens=200)
                        # 自动关闭 HTTP 会话

6. 常用场景

• OpenClaw: config.yaml 配置 webhook URL
• LangChain: 自定义 CallbackHandler
• Cursor/Codex: 在代码中直接调用 report()

7. API 参考

8. 常见问题

• Q: 上报失败会影响我的 AI 调用吗？ A: 不会，上报是独立的网络请求。
• Q: 数据多久能显示？ A: 实时上报，刷新页面即可看到。
• Q: 如何查看已上报的数据？ A: 登录虾算账，在「总览」页面查看。

基于您的历史使用数据，我们为您推荐更具性价比的模型方案。