项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 2004
使用教程
⚠ 本教程由 AI 依据该项目 README 整理;原始文档不完整,部分步骤为通用流程推断,实际安装请以项目官方文档为准。
⚠ 该项目 README 未提供完整安装说明,以下步骤为通用流程,请以官方文档为准。
环境要求
- 可运行 Python 的环境(README 未标注具体版本)
- 能从 PyPI 安装第三方包的网络环境
- 已知要估算的模型名称,如 gpt-3.5-turbo
安装与启动步骤
-
1安装 tokencost
从 PyPI 安装该库。README 的 Installation 章节为空,包名取自 README 中的 PyPI 项目链接,请以实际 PyPI 页面为准。
pip install tokencost -
2编写调用示例
按 README 示例导入两个函数,构造 messages 格式的 prompt 并调用,得到输入与输出成本。
from tokencost import calculate_prompt_cost, calculate_completion_cost model = "gpt-3.5-turbo" prompt = [{ "role": "user", "content": "Hello world"}] completion = "How may I assist you today?" prompt_cost = calculate_prompt_cost(prompt, model) completion_cost = calculate_completion_cost(completion, model) print(f"{prompt_cost} + {completion_cost} = {prompt_cost + completion_cost}") -
3运行脚本
把上一步代码保存为 cost.py 后执行,终端会输出 prompt 成本、completion 成本及两者之和。
python cost.py -
4替换模型再估算
把 model 变量换成你要评估的模型名,即可对比不同模型的预估费用;具体支持哪些模型以库内价格表为准。
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
model | 是 | 模型名称,库据此匹配对应价格表 | gpt-3.5-turbo |
prompt | 是 | 消息列表,用于计算输入 token 成本 | [{"role": "user", "content": "Hello world"}] |
completion | 是 | 模型输出文本,用于计算输出 token 成本 | How may I assist you today? |
如何确认成功
运行脚本后终端打印出形如 0.0000135 的美元金额,即表示安装与调用成功。
常见问题
Q:使用前需要填 API Key 吗?
A:不需要。README 示例中直接传入模型名与文本即可计算,属于客户端本地估算,不会实际调用模型接口。
Q:支持哪些模型?
A:README 未给出模型清单,仅示例使用 gpt-3.5-turbo;项目简介称覆盖 400 多个主流 LLM,具体以库内价格表为准。
Q:怎么分别算输入和输出成本?
A:输入用 calculate_prompt_cost(prompt, model),输出用 calculate_completion_cost(completion, model),也可相加得到总成本。
Q:算出来的价格为什么和账单有差异?
A:结果是基于价格表与 token 数的估算值,厂商调价或计费规则变化时会有偏差,最终以官方账单为准。
注意事项
- README 的 Installation 与 Usage 章节内容为空,pip install tokencost 是依据 README 中 PyPI 项目链接推断的包名。
- 示例输出中的 0.0000135 为 README 给出的参考值,实际数值随文本长度变化。
- prompt 需为带 role 和 content 的消息列表,不能直接传纯字符串。
核心亮点
- 覆盖 400+ 模型,价格数据持续更新,省去手动查表
- API 极简,两行代码返回估算成本,学习成本低
- 内置 CLI 工具,无需写代码即可快速测试
不足之处
- 价格数据依赖社区维护,新模型价格可能滞后
- 仅提供估算,不包含实际账单或用量统计功能
适用场景
- 在多个 LLM 之间做成本对比,辅助选型
- 开发阶段估算 API 调用费用,控制预算
- 在 CI/CD 中集成成本检查,防止超支
替代项目
openai-cost、llm-cost、LangChain 的 cost_calculator
上一篇:llama_deploy
下一篇:ai-gateway
同类项目推荐
comfyui-model-linker
开源
一键补全 ComfyUI 缺失模型,自动匹配下载,告别报错。
Relink missing models in ComfyUI workflows with fuzzy matching, and download them fr···
mlx-serve
开源
在 Mac 上原生跑 LLM,兼容 OpenAI/Anthropic API,无需 Python
Native LLM inference server for Apple Silicon. OpenAI + Anthropic API compatible. No···
kubeflow-manifests
开源
在 AWS EKS 上快速部署 KubeFlow,省去手动配置烦恼
KubeFlow on AWS
comfy-kitchen
开源
给扩散推理换装多后端快算子
Fast kernel library for Diffusion inference with multiple compute backends.
jellyfin
开源
免费开源媒体服务器,自己掌控影音库,随时随处播放
The Free Software Media System - Server Backend & API
SageAttention
开源
渲染提速好几倍,出片快人一步
[ICLR2025, ICML2025, NeurIPS2025 Spotlight] Quantized Attention achieves speedup of ···
opik-mcp
开源
在 Claude Code 里直接查 Opik 追踪、打分、管提示词
Model Context Protocol (MCP) server for Opik, the open-source LLM observability and ···
feast
开源
统一管理 ML 特征,让训练和上线用同一份数据
The Open Source Feature Store for AI/ML
clearml-fractional-gpu
开源
一块GPU跑多个容器,显存限制+时间切片,利用率翻倍
ClearML Fractional GPU - Run multiple containers on the same GPU with driver level m···
