ACG 文档

环境变量

ai-cost-gate 启动时读取的环境变量参考。

上游 provider

ai-cost-gate 代理任何 OpenAI 兼容端点。要用哪个 provider 就设对应的凭据。

# OpenAI
UPSTREAM_OPENAI_API_KEY=sk-...
UPSTREAM_OPENAI_BASE=https://api.openai.com/v1

# Anthropic(通过 OpenAI 兼容适配器)
UPSTREAM_ANTHROPIC_API_KEY=sk-ant-...
UPSTREAM_ANTHROPIC_BASE=https://api.anthropic.com/v1

# DeepSeek、Volcano Engine、OpenRouter 或任何 OpenAI 兼容端点
UPSTREAM_CUSTOM_BASE=https://api.example.com/v1
UPSTREAM_CUSTOM_API_KEY=...

数据库

DATABASE_URL=sqlite:///data/ai-cost-gate.db

整库一个 SQLite 文件。容器必须对目录可写。建议用 Docker volume。

Admin

ADMIN_TOKEN=change-me

Admin UI 和 /internal/* 接口都要。生产环境请定期轮换。

服务

LISTEN_HOST=0.0.0.0
LISTEN_PORT=3000
PROXY_PORT=8080

预算(可选)

请求没有 project 级 budget header 时使用的默认值:

DEFAULT_PER_REQUEST_BUDGET_CENTS=100
DEFAULT_PER_PROJECT_BUDGET_CENTS=10000
DEFAULT_GLOBAL_BUDGET_CENTS=100000

auto_stop 按 project 单独开启。在 dashboard 配。

日志

LOG_LEVEL=info
LOG_FORMAT=json

LOG_LEVELdebug/info/warn/errorLOG_FORMAT=json 输出结构化日志,方便对接 Loki、CloudWatch 等。

另见

  • 部署 —— 生产环境跑 ai-cost-gate
  • 项目结构 —— 每个 env 在哪里被读

On this page