Exporter provider reference

Every provider the exporter reads, and the environment variables each one takes

This page is generated from the exporter’s provider registry, so the variables here are exactly the ones the code reads. Each provider is run with --provider <name>; a variable can come from a flag, the config file, or the environment.

Alibaba Cloud

--provider alibaba (Cloud (IaaS))

Grain: instance bill (instance x product, per day). Reads the current month by default; pass --month or --start/--end for another window.

Provider documentation: https://docs.costgraph.ai/costgraph/integrations/alibaba

Variable	Required	Secret	Description
ALIBABA_ACCESS_KEY_ID	yes	no	AccessKey ID of a RAM user with the AliyunBSSReadOnlyAccess policy (RAM console -> Users -> Create AccessKey).
ALIBABA_ACCESS_KEY_SECRET	yes	yes	AccessKey secret shown once when the AccessKey is created for that RAM user.
ALIBABA_SITE	no	no	Which Alibaba Cloud site the account is on: international (alibabacloud.com, the default) or china (aliyun.com).

Anthropic

--provider anthropic (AI / LLM)

Grain: day x model x token bucket (cost + tokens). Reads the current month by default; pass --month or --start/--end for another window.

Provider documentation: https://docs.costgraph.ai/costgraph/integrations/anthropic

Variable	Required	Secret	Description
ANTHROPIC_ADMIN_KEY	yes	yes	Admin API key from the Anthropic Console (Settings -> Admin keys). Grants org-wide read of usage and cost reports.
ANTHROPIC_ORG_ID	no	no	Organization the key belongs to. Only needed when the key can see more than one org; otherwise it is resolved for you.
ANTHROPIC_TENANT_GROUP	no	no	Workspace field used to split charges into tenants. Leave empty to bill the whole organization as one tenant.

Azure

--provider azure (Cloud)

Grain: day x resource x service, as the FOCUS export publishes it. Reads the current month by default; pass --month or --start/--end for another window.

Provider documentation: https://docs.costgraph.ai/costgraph/integrations/azure

Variable	Required	Secret	Description
AZURE_TENANT_ID	yes	no	Tenant id of the Entra ID app (service principal) reading the export. Shown as the directory ID on the app’s Overview page.
AZURE_CLIENT_ID	yes	no	Client id (application id) of the service principal. The Cloud Shell setup script creates it with Storage Blob Data Reader on the export’s storage account.
AZURE_CLIENT_SECRET	yes	yes	Client secret of the service principal. Shown once when created.
AZURE_STORAGE_ACCOUNT	yes	no	Storage account the FOCUS export writes to, from Cost Management + Billing -> Exports.
AZURE_CONTAINER	yes	no	Container inside the storage account that holds the export.
AZURE_EXPORT_NAME	no	no	Folder the export writes into. Leave empty to read everything in the container; only set it to read one export among several.

Baseten

--provider baseten (AI / LLM)

Grain: day x model x token type (model APIs), day x deployment (dedicated), day x job (training). Reads the current month by default; pass --month or --start/--end for another window.

Provider documentation: https://docs.costgraph.ai/costgraph/integrations/baseten

Variable	Required	Secret	Description
BASETEN_API_KEY	yes	yes	Baseten API key with organization scope. Create one under Settings -> API keys; it reads the whole organization’s billing, not just your own.

Blacksmith

--provider blacksmith (CI / build acceleration)

Grain: day x org (billed CI runner spend), plus per-runner-type utilization signals; falls back to month x org billable minutes when Blacksmith withholds cost. Reads the current month by default; pass --month or --start/--end for another window.

Provider documentation: https://docs.costgraph.ai/costgraph/integrations/blacksmith

Variable	Required	Secret	Description
BLACKSMITH_API_TOKEN	yes	yes	Blacksmith organization token. Create it with blacksmith org-token create; an org-scoped token is required.
BLACKSMITH_ORG	yes	no	The GitHub organization login exactly as it appears on GitHub, case-sensitive (e.g. AcmeCorp, not acmecorp). This is the org whose CI usage is exported.
BLACKSMITH_RATE_PER_MINUTE	no	no	Optional price per billable minute in USD, from your Blacksmith invoice (e.g. 0.004). Set it to have minutes priced when Blacksmith does not return cost for this credential.

Buildkite

--provider buildkite (Developer platform / CI)

Grain: month x user seat (billable unit) with per-user build activity as the active-vs-assigned value signal. Reads the current month by default; pass --month or --start/--end for another window.

Provider documentation: https://docs.costgraph.ai/costgraph/integrations/buildkite

Variable	Required	Secret	Description
BUILDKITE_API_TOKEN	yes	yes	Buildkite API access token (User Settings -> API Access Tokens) with the read_organizations, read_builds and read_user scopes.
BUILDKITE_ORG	yes	no	The organization slug in the buildkite.com/ URL path, whose seats are exported.
BUILDKITE_SEAT_PRICE	no	no	Optional per-user monthly price in USD used to value each seat. Leave empty to report seats without a cost.

Cherry Servers

--provider cherryservers (Cloud (bare metal))

Grain: resource run-rate (server x project, prorated to the window). Reads the current month by default; pass --month or --start/--end for another window.

Provider documentation: https://docs.costgraph.ai/costgraph/integrations/cherryservers

Variable	Required	Secret	Description
CHERRY_TOKEN	yes	yes	Cherry Servers API key (Dashboard -> API keys).
CHERRY_TEAM_ID	no	no	Optional team id to export. When empty every team the token can read is exported.

ClickHouse Cloud

--provider clickhouse (Managed database)

Grain: usage cost record (service x metric x day). Reads the current month by default; pass --month or --start/--end for another window.

Provider documentation: https://docs.costgraph.ai/costgraph/integrations/clickhouse

Variable	Required	Secret	Description
CLICKHOUSE_KEY_ID	yes	yes	ClickHouse Cloud API key id (Organization -> API keys). A read-only Developer key can read usage cost.
CLICKHOUSE_KEY_SECRET	yes	yes	ClickHouse Cloud API key secret paired with the key id.
CLICKHOUSE_ORG_ID	no	no	Optional organization id. When empty it is resolved automatically (the key belongs to one organization).

Cloudflare

--provider cloudflare (Cloud / edge)

Grain: billable-usage line item (service x day, FOCUS-native fields). Reads the current month by default; pass --month or --start/--end for another window.

Provider documentation: https://docs.costgraph.ai/costgraph/integrations/cloudflare

Variable	Required	Secret	Description
CLOUDFLARE_API_TOKEN	yes	yes	Cloudflare API token with the ‘Billing Read’ permission (account scope).
CLOUDFLARE_ACCOUNT_ID	yes	no	Cloudflare account id whose billable usage is exported.

Confluent Cloud

--provider confluent (Streaming (Kafka))

Grain: billing line item (product x resource). Reads the current month by default; pass --month or --start/--end for another window.

Provider documentation: https://docs.costgraph.ai/costgraph/integrations/confluent

Variable	Required	Secret	Description
CONFLUENT_CLOUD_API_KEY	yes	yes	Cloud API key (not a cluster key) created under Confluent Cloud -> API keys, scoped to the organization.
CONFLUENT_CLOUD_API_SECRET	yes	yes	Secret shown once when the Cloud API key is created. Pair it with the key above.
CONFLUENT_ORG_ID	yes	no	Confluent organization ID whose billing the Cost API returns. Found in Settings -> Organization.

Convex

--provider convex (Backend platform)

Grain: current month x deployment x metered dimension (usage, charged only above the plan allowance), plus developer seats. Reads the current month by default; pass --month or --start/--end for another window.

Provider documentation: https://docs.costgraph.ai/costgraph/integrations/convex

Variable	Required	Secret	Description
CONVEX_ACCESS_TOKEN	yes	yes	Convex team access token (team settings) or personal access token (user settings). A team token reads usage; a personal token is needed to also count developer seats.
CONVEX_TEAM_ID	no	no	Optional Convex team id. Leave it empty to use the team the token belongs to.
CONVEX_SEAT_RATE	no	no	Optional USD per developer per month. Defaults to Convex’s published Professional rate of 25. Set it if your team is on negotiated pricing.

CostGraph

--provider costgraph (FinOps platform)

Grain: billing period x workspace x meter, plus a row per fee, tax and credit. Reads the current month by default; pass --month or --start/--end for another window.

Provider documentation: https://docs.costgraph.ai/costgraph/integrations/costgraph

Variable	Required	Secret	Description
COSTGRAPH_API_KEY	yes	yes	API key with the focus:read scope. Reads what your organization owes CostGraph.
COSTGRAPH_URL	no	no	API base URL. Defaults to https://api.costgraph.ai.

Cursor

--provider cursor (AI coding agent)

Grain: day x model x user (charged spend). Reads the current month by default; pass --month or --start/--end for another window.

Provider documentation: https://docs.costgraph.ai/costgraph/integrations/cursor

Variable	Required	Secret	Description
CURSOR_API_KEY	yes	yes	Cursor Team/Enterprise Admin API key (Cursor dashboard -> Settings -> Team -> API Keys).
CURSOR_TEAM	no	no	Label for the billing account (your Cursor team name). Optional; defaults to “Cursor”.

Datadog

--provider datadog (Observability)

Grain: cost report line item (org x product x charge type, monthly). Reads the current month by default; pass --month or --start/--end for another window.

Provider documentation: https://docs.costgraph.ai/costgraph/integrations/datadog

Variable	Required	Secret	Description
DATADOG_ACCESS_TOKEN	yes	yes	Datadog access token scoped to usage_read and billing_read (Personal Settings -> Access Tokens): a service access token (ddsat_) for an unattended sync, or a personal access token (ddpat_). For an unattended sync create a service access token with expiration set to Never so it does not lapse. It must belong to the parent organization.
DATADOG_SITE	no	no	Datadog site the account lives on, e.g. datadoghq.com, datadoghq.eu, us3.datadoghq.com, us5.datadoghq.com, ap1.datadoghq.com. Sets the API host. Defaults to datadoghq.com.

Daytona

--provider daytona (Cloud (dev environments))

Grain: sandbox run-rate (sandbox x organization, prorated to the window). Reads the current month by default; pass --month or --start/--end for another window.

Provider documentation: https://docs.costgraph.ai/costgraph/integrations/daytona

Variable	Required	Secret	Description
DAYTONA_API_KEY	yes	yes	Daytona API key (Dashboard -> Keys).
DAYTONA_ORGANIZATION_ID	no	no	Optional organization id to scope the export. When empty the key’s default organization is used.

Depot

--provider depot (Developer tools (CI/CD))

Grain: usage cost record (product x project/repo x window). Reads the current month by default; pass --month or --start/--end for another window.

Provider documentation: https://docs.costgraph.ai/costgraph/integrations/depot

Variable	Required	Secret	Description
DEPOT_API_TOKEN	yes	yes	Depot organization token. Create it in Organization settings -> API tokens.
DEPOT_ORGANIZATION_ID	no	no	Optional organization identifier used as a label. The token is already scoped to one organization; when unset the label is “depot”.
DEPOT_BUILD_MINUTE_RATE	no	no	Optional USD per container-build minute. Defaults to Depot’s published 16 vCPU rate 0.04.
DEPOT_RUNNER_MINUTE_RATE	no	no	Optional USD per GitHub Actions runner minute. Depot does not report runner size, so when unset runner minutes are exported unpriced.
DEPOT_SANDBOX_MINUTE_RATE	no	no	Optional USD per agent-sandbox minute. Defaults to 0.006 (2 vCPU published rate).
DEPOT_STORAGE_GB_RATE	no	no	Optional USD per cache/registry GB-month. Defaults to Depot’s published 0.20.

DigitalOcean

--provider digitalocean (Cloud (IaaS))

Grain: invoice line item (product x resource). Reads the current month by default; pass --month or --start/--end for another window.

Provider documentation: https://docs.costgraph.ai/costgraph/integrations/digitalocean

Variable	Required	Secret	Description
DIGITALOCEAN_TOKEN	yes	yes	Personal Access Token that can read billing (Account -> API -> Tokens). A classic read token works; a fine-grained token needs billing:read (and account:read to label the billing account).
DIGITALOCEAN_ACCOUNT_ID	no	no	Optional label for the billing account. When empty it is resolved automatically.

ElevenLabs

--provider elevenlabs (AI / LLM)

Grain: day x model, or day x member when workspace metrics on (credit usage) + plan quota snapshot. Reads the current month by default; pass --month or --start/--end for another window.

Provider documentation: https://docs.costgraph.ai/costgraph/integrations/elevenlabs

Variable	Required	Secret	Description
ELEVENLABS_API_KEY	yes	yes	ElevenLabs API key with read access to usage and subscription. Created under Profile -> API keys.
ELEVENLABS_ACCOUNT_ID	no	no	Label for the ElevenLabs workspace this key belongs to, used as the billing account id. Defaults to elevenlabs when unset.
ELEVENLABS_WORKSPACE_METRICS	no	no	Set true to attribute usage per workspace member instead of per model. Needs a key with workspace read access; falls back to per-model if the key lacks it. Defaults to false.

Fireworks AI

--provider fireworks (AI / LLM)

Grain: day x model x token type (serverless), day x deployment x accelerator (dedicated), plus a quota snapshot. Reads the current month by default; pass --month or --start/--end for another window.

Provider documentation: https://docs.costgraph.ai/costgraph/integrations/fireworks

Variable	Required	Secret	Description
FIREWORKS_API_KEY	yes	yes	Fireworks API key. Create one under Account Settings -> API Keys. The user it belongs to needs the account administrator role, otherwise the cost query returns only that user’s own spend.
FIREWORKS_ACCOUNT_ID	yes	no	Account slug the usage is billed to, shown in the console URL and in firectl output.

GitHub

--provider github (Developer platform / CI)

Grain: day x product x SKU x repository (gross/net billed cost). Reads the current month by default; pass --month or --start/--end for another window.

Provider documentation: https://docs.costgraph.ai/costgraph/integrations/github

Variable	Required	Secret	Description
GITHUB_TOKEN	yes	yes	Read-only token for the organization’s billing, Actions artifact and cache storage, and Copilot usage. Fine-grained PAT (recommended): choose the organization as resource owner first, then repository access = all repositories, organization Administration: read and GitHub Copilot Business: read, repository Actions: read and Administration: read. Classic PAT: repo, read:org and copilot.
GITHUB_ORG	yes	no	The organization login in the github.com/ URL path, whose billing usage is exported.

GitHub Actions jobs

--provider github_actions (CI / build acceleration)

Grain: day x repository x runner vendor and size x workflow x trigger x pull request or branch x actor x outcome x attempt (billed runner minutes of every GitHub Actions job, on GitHub-hosted, managed vendor and self-hosted runners; priced by CostGraph); reads yesterday and today. Reads the current month by default; pass --month or --start/--end for another window.

Provider documentation: https://docs.costgraph.ai/costgraph/integrations/github

Variable	Required	Secret	Description
GITHUB_TOKEN	yes	yes	GitHub token for the organization, supplied by the GitHub connection.
GITHUB_ORG	yes	no	The organization login in the github.com/ URL path.

Grafana Cloud

--provider grafanacloud (Observability)

Grain: billed dimension x stack (per-stack attributed cost). Reads the current month by default; pass --month or --start/--end for another window.

Provider documentation: https://docs.costgraph.ai/costgraph/integrations/grafanacloud

Variable	Required	Secret	Description
GRAFANA_CLOUD_TOKEN	yes	yes	Grafana Cloud Access Policy token (glc_) whose realm is the org and which carries billing read scopes (billing-metrics:read, org-billing-info:read, org-billing-rate:read, invoices:read, orgs:read). A stack service-account token (glsa_) does not work.
GRAFANA_CLOUD_ORG	yes	no	The Grafana Cloud organization slug in the grafana.com/orgs/ URL path, whose billed usage is exported.

Hatchet Cloud

--provider hatchet (Task orchestration)

Grain: task-run cost record (tenant x day). Reads the current month by default; pass --month or --start/--end for another window.

Provider documentation: https://docs.costgraph.ai/costgraph/integrations/hatchet

Variable	Required	Secret	Description
HATCHET_CLIENT_TOKEN	yes	yes	One or more comma-separated Hatchet client tokens (Settings -> API Tokens), one per tenant; a client token is scoped to a single tenant so multiple tenants need multiple tokens.
HATCHET_SERVER_URL	no	no	Optional API base URL override applied to every token. Defaults to the URL embedded in each token.
HATCHET_INCLUDED_RUNS	no	no	Optional monthly free task-run allowance for the plan (Developer includes 100000). The free runs each month are not billed; only overage is rated. Applied to every tenant.
HATCHET_MONTHLY_BASE_FEE	no	no	Optional plan platform fee in USD per calendar month (Team 500, Scale 1000, Developer 0). Applied to every tenant.
HATCHET_RUN_RATE	no	no	Negotiated per-task-run price in USD for Dedicated/Enterprise Hatchet deployments (overrides the public $10 per 1,000,000 list rate). Leave empty for standard usage plans. Applied to every tenant.

Helicone

--provider helicone (AI gateway / observability)

Grain: day x model x upstream provider (request spend). Reads the current month by default; pass --month or --start/--end for another window.

Provider documentation: https://docs.costgraph.ai/costgraph/integrations/helicone

Variable	Required	Secret	Description
HELICONE_API_KEY	yes	yes	Helicone API key with read access to usage and cost. Created under Settings -> API keys.
HELICONE_ORG_ID	yes	no	Organization whose spend is exported. Shown in the Helicone dashboard URL and under Settings -> Organization.
HELICONE_TENANT_PROPERTY	no	no	Custom request property to break spend down by, e.g. customer_id. Leave empty to bill the org as one tenant.

IBM Cloud

--provider ibm (Cloud (IaaS))

Grain: month x resource instance x plan, as IBM’s FOCUS report publishes it. Reads the current month by default; pass --month or --start/--end for another window.

Provider documentation: https://docs.costgraph.ai/costgraph/integrations/ibm

Variable	Required	Secret	Description
IBM_API_KEY	yes	yes	IBM Cloud API key of a user or service ID with the Billing Administrator role on the account. Create it under Manage -> Access (IAM) -> API keys; it is shown only once.
IBM_ACCOUNT_ID	no	no	Account id whose bill is exported, from Manage -> Account -> Account settings. Leave empty to use the account the API key belongs to.

Akamai Cloud (Linode)

--provider linode (Cloud (IaaS))

Grain: invoice line item (service x resource, per invoice). Reads the current month by default; pass --month or --start/--end for another window.

Provider documentation: https://docs.costgraph.ai/costgraph/integrations/linode

Variable	Required	Secret	Description
LINODE_TOKEN	yes	yes	Linode / Akamai Cloud personal access token with the account:read_only scope (Profile -> API Tokens).
LINODE_ACCOUNT_ID	no	no	Optional label for the billing account. When empty it is resolved automatically.

LiteLLM

--provider litellm (AI gateway)

Grain: day x model x virtual key (tracked spend). Reads the current month by default; pass --month or --start/--end for another window.

Provider documentation: https://docs.costgraph.ai/costgraph/integrations/litellm

Variable	Required	Secret	Description
LITELLM_BASE_URL	yes	no	Base URL of your LiteLLM proxy, e.g. https://litellm.mycompany.com.
LITELLM_MASTER_KEY	yes	yes	LiteLLM proxy master key (sk-…). Required to read spend across all virtual keys.

Microsandbox Cloud

--provider microsandbox (Compute)

Grain: day x sandbox, day x volume, plus a quota snapshot. Reads the current month by default; pass --month or --start/--end for another window.

Provider documentation: https://docs.costgraph.ai/costgraph/integrations/microsandbox

Variable	Required	Secret	Description
MICROSANDBOX_API_KEY	yes	yes	Organization API key (msb_ak_…), created in the microsandbox console. It is org-scoped and reads the whole organization’s usage.

Modal

--provider modal (Serverless GPU / compute)

Grain: day x object (per-resource CPU/mem/GPU cost). Reads the current month by default; pass --month or --start/--end for another window.

Provider documentation: https://docs.costgraph.ai/costgraph/integrations/modal

Variable	Required	Secret	Description
MODAL_TOKEN_ID	yes	yes	Token ID half of a Modal API token (modal token new, or Settings -> API tokens).
MODAL_TOKEN_SECRET	yes	yes	Token secret half of the same Modal API token. Shown only at creation time.
MODAL_WORKSPACE_ID	yes	no	Modal workspace whose compute charges are exported. Shown in the dashboard URL.

New API

--provider newapi (AI gateway)

Grain: day x model x token (tracked quota spend). Reads the current month by default; pass --month or --start/--end for another window.

Provider documentation: https://docs.costgraph.ai/costgraph/integrations/newapi

Variable	Required	Secret	Description
NEWAPI_BASE_URL	yes	no	Base URL of your new-api / one-api deployment, e.g. https://newapi.mycompany.com.
NEWAPI_ACCESS_TOKEN	yes	yes	Dashboard access token (PAT) of an admin account, generated at Profile -> Security -> Access Token (not an inference sk- API key). Admin access is required to read usage across all users.
NEWAPI_QUOTA_PER_UNIT	no	no	Quota credits per US dollar for USD conversion. Must match the deployment’s QuotaPerUnit setting. Defaults to 500000 (new-api default).

Object Store

--provider objectstore (Bill published to storage)

Grain: whatever the published bill carries (a row per resource, service and day for most providers). Reads the current month by default; pass --month or --start/--end for another window.

Provider documentation: https://docs.costgraph.ai/costgraph/integrations/objectstore

Variable	Required	Secret	Description
OBJECTSTORE_BUCKET	yes	no	Bucket the provider writes the bill into.
OBJECTSTORE_ENDPOINT	no	no	S3-compatible endpoint, for example https://object.storage.eu01.stackit.schwarz. Leave empty for AWS S3.
OBJECTSTORE_REGION	no	no	Region the bucket lives in. Defaults to us-east-1, which most S3-compatible stores ignore.
OBJECTSTORE_PREFIX	no	no	Path within the bucket to read. Leave empty to read the whole bucket.
OBJECTSTORE_ACCESS_KEY_ID	no	yes	Access key with read permission on the bucket. On Azure Blob Storage, a service principal instead: <tenant id>/<client id> of an app granted Storage Blob Data Reader. Leave empty on AWS to use the role or profile the exporter already runs as.
OBJECTSTORE_SECRET_ACCESS_KEY	no	yes	Secret for the access key, or the client secret of the service principal on Azure Blob Storage.
OBJECTSTORE_KIND	no	no	The storage backend the bill lives in: s3 for AWS S3 or any S3-compatible store (the default), azure for Azure Blob Storage, or local for a directory on disk. Usually inferred from the endpoint, so you rarely set it.
OBJECTSTORE_LAYOUT	no	no	How to tell which files make up a billing period: flat (the default) reads every file under the prefix; latest-run reads only the newest export when the provider rewrites the period on each run (STACKIT); manifest reads exactly the files a published manifest lists (AWS, Azure).

Oracle Cloud Infrastructure

--provider oci (Cloud (IaaS))

Grain: hour x resource x SKU, as OCI’s FOCUS cost report publishes it. Reads the current month by default; pass --month or --start/--end for another window.

Provider documentation: https://docs.costgraph.ai/costgraph/integrations/oci

Variable	Required	Secret	Description
OCI_TENANCY_OCID	yes	no	OCID of your tenancy, from Profile -> Tenancy in the OCI Console.
OCI_USER_OCID	yes	no	OCID of the user that owns the API key, from Identity -> Users -> the user’s details. The user’s group needs a policy that lets it read the cost reports.
OCI_FINGERPRINT	yes	no	Fingerprint of the API key, shown next to the key under the user’s API keys.
OCI_PRIVATE_KEY	yes	yes	Private key (PEM) of the API key, downloaded when you added the key under the user’s API keys. Keys protected by a passphrase are not supported.
OCI_REGION	yes	no	Home region of the tenancy, for example us-ashburn-1, from Profile -> Tenancy.

OpenAI

--provider openai (AI / LLM)

Grain: day x model x token bucket (billed cost + quantity). Reads the current month by default; pass --month or --start/--end for another window.

Provider documentation: https://docs.costgraph.ai/costgraph/integrations/openai

Variable	Required	Secret	Description
OPENAI_ADMIN_KEY	yes	yes	Admin key from the OpenAI platform (Settings -> Admin keys) with the api.usage.read scope. Required for the org usage and costs endpoints; a normal project key will not work.
OPENAI_ORG_ID	yes	no	Organization the charges belong to, in the form org-… Found under Settings -> Organization.
OPENAI_TENANT_GROUP	no	no	Project field used to split charges into tenants. Leave empty to bill the whole organization as one tenant.

OpenRouter

--provider openrouter (AI gateway)

Grain: day x model x upstream provider (credit spend). Reads the current month by default; pass --month or --start/--end for another window.

Provider documentation: https://docs.costgraph.ai/costgraph/integrations/openrouter

Variable	Required	Secret	Description
OPENROUTER_MANAGEMENT_KEY	yes	yes	Management key from OpenRouter -> Settings -> Management keys. Read access to activity and credits.
OPENROUTER_ORG_ID	yes	no	OpenRouter organization whose activity is exported.

OVHcloud

--provider ovhcloud (Cloud (IaaS))

Grain: invoice line item (service x resource, per bill). Reads the current month by default; pass --month or --start/--end for another window.

Provider documentation: https://docs.costgraph.ai/costgraph/integrations/ovhcloud

Variable	Required	Secret	Description
OVH_CLIENT_ID	yes	yes	OVHcloud OAuth2 service-account client id (region-prefixed, e.g. EU.xxxx / CA.xxxx / US.xxxx). Created under the OVHcloud manager. The prefix selects the API region.
OVH_CLIENT_SECRET	yes	yes	OVHcloud OAuth2 service-account client secret paired with OVH_CLIENT_ID.
OVH_SERVICE_NAME	no	no	Optional Public Cloud project id to scope current-month usage to. When empty, every project the token can see is included; the account bills are always exported.

PlanetScale

--provider planetscale (Managed database)

Grain: invoice month x database x billing metric.

Provider documentation: https://docs.costgraph.ai/costgraph/integrations/planetscale

Variable	Required	Secret	Description
PLANETSCALE_SERVICE_TOKEN_ID	no	yes	Short ID of a PlanetScale service token, shown next to the token in Settings -> Service tokens. Provide it with PLANETSCALE_SERVICE_TOKEN, or use PLANETSCALE_ACCESS_TOKEN instead.
PLANETSCALE_SERVICE_TOKEN	no	yes	The service token value itself. It needs read_branch and organization billing access, and is already scoped to one organization.
PLANETSCALE_ACCESS_TOKEN	no	yes	OAuth access token granted to a PlanetScale OAuth application with read_organizations, read_invoices, read_databases, read_branches and read_metrics_endpoints. Alternative to the service token pair.
PLANETSCALE_ORGANIZATION	no	no	Organization name to export. Only needed when the credential can see more than one organization.

Redis Cloud

--provider rediscloud (Managed database)

Grain: cost-report line item (subscription/database x usage period). Reads the current month by default; pass --month or --start/--end for another window.

Provider documentation: https://docs.costgraph.ai/costgraph/integrations/rediscloud

Variable	Required	Secret	Description
REDISCLOUD_ACCOUNT_KEY	yes	yes	Redis Cloud account-level API key (Account Settings -> enable the API). The account needs the Owner, Billing admin, or Viewer role, and the cost report is in limited availability (request access from Redis support).
REDISCLOUD_USER_KEY	yes	yes	Redis Cloud user-level secret key (Account Settings -> API keys), paired with the account key.

RespanAI

--provider respanai (AI gateway / observability)

Grain: day x model x upstream provider (request spend). Reads the current month by default; pass --month or --start/--end for another window.

Provider documentation: https://docs.costgraph.ai/costgraph/integrations/respanai

Variable	Required	Secret	Description
RESPANAI_API_KEY	yes	yes	RespanAI (formerly KeywordsAI) API key with read access to usage and cost.
RESPANAI_ORG_ID	yes	no	RespanAI organization whose spend is exported.
RESPANAI_TENANT_FIELD	no	no	Request field to break spend down by, e.g. customer_identifier. Leave empty to bill the org as one tenant.

RunPod

--provider runpod (Cloud (GPU))

Grain: billed cost record (pod/endpoint x GPU type x day). Reads the current month by default; pass --month or --start/--end for another window.

Provider documentation: https://docs.costgraph.ai/costgraph/integrations/runpod

Variable	Required	Secret	Description
RUNPOD_API_KEY	yes	yes	RunPod API key (Settings -> API Keys).
RUNPOD_ACCOUNT_ID	no	no	Optional RunPod account id used as a label. When unset it is resolved automatically.

Scaleway

--provider scaleway (Cloud (IaaS))

Grain: billing charge (project x SKU x resource), daily allocation. Reads the current month by default; pass --month or --start/--end for another window.

Provider documentation: https://docs.costgraph.ai/costgraph/integrations/scaleway

Variable	Required	Secret	Description
SCALEWAY_SECRET_KEY	yes	yes	IAM API key secret key with the BillingReadOnly permission set.
SCALEWAY_ORGANIZATION_ID	no	no	Organization id whose charges are exported. When empty it is resolved from SCALEWAY_ACCESS_KEY automatically.
SCALEWAY_ACCESS_KEY	yes	no	IAM API key access key (the public half, e.g. SCW…). Pairs with the secret key and resolves the organization when SCALEWAY_ORGANIZATION_ID is not set.
SCALEWAY_PROJECT_ID	no	no	Optional project id to narrow the export to a single project. When empty, every project under the organization is exported.

STACKIT

--provider stackit (Cloud (IaaS))

Grain: cost report datapoint (project x service/SKU, daily). Reads the current month by default; pass --month or --start/--end for another window.

Provider documentation: https://docs.costgraph.ai/costgraph/integrations/stackit

Variable	Required	Secret	Description
STACKIT_SERVICE_ACCOUNT_KEY	no	yes	Service account key JSON (the full key object with a credentials block). Provide this or STACKIT_SERVICE_ACCOUNT_KEY_PATH.
STACKIT_SERVICE_ACCOUNT_KEY_PATH	no	no	Path to the service account key JSON file. Alternative to STACKIT_SERVICE_ACCOUNT_KEY.
STACKIT_PRIVATE_KEY	no	yes	PEM-encoded RSA private key for the service account. Only needed when the key JSON has no embedded credentials.privateKey. Provide this or STACKIT_PRIVATE_KEY_PATH.
STACKIT_PRIVATE_KEY_PATH	no	no	Path to the PEM-encoded RSA private key file. Alternative to STACKIT_PRIVATE_KEY.
STACKIT_CUSTOMER_ACCOUNT_ID	yes	no	Customer account id whose costs are exported. The service account needs the cost-management.cost.reader role on it.
STACKIT_PROJECT_ID	no	no	Optional project id to scope the export to a single project. When empty, every project under the customer account is exported.

TrueFoundry

--provider truefoundry (AI gateway)

Grain: day x model x virtual account (gateway-computed spend). Reads the current month by default; pass --month or --start/--end for another window.

Provider documentation: https://docs.costgraph.ai/costgraph/integrations/truefoundry

Variable	Required	Secret	Description
TRUEFOUNDRY_BASE_URL	yes	no	Control plane URL of your TrueFoundry deployment, e.g. https://your-org.truefoundry.cloud.
TRUEFOUNDRY_API_KEY	yes	yes	TrueFoundry Personal Access Token or Virtual Account Token with read access to gateway metrics.

UpCloud

--provider upcloud (Cloud (IaaS))

Grain: monthly billing summary (resource x service, per month). Reads the current month by default; pass --month or --start/--end for another window.

Provider documentation: https://docs.costgraph.ai/costgraph/integrations/upcloud

Variable	Required	Secret	Description
UPCLOUD_API_TOKEN	yes	yes	UpCloud API token for an account with the billing permission (Control Panel -> Account -> API tokens).

Vercel

--provider vercel (Frontend cloud / PaaS)

Grain: day x service x project (FOCUS-native charges). Reads the current month by default; pass --month or --start/--end for another window.

Provider documentation: https://docs.costgraph.ai/costgraph/integrations/vercel

Variable	Required	Secret	Description
VERCEL_TOKEN	yes	yes	Vercel access token (Account Settings -> Tokens) with a role that can read billing (Owner, Member, Billing, …).
VERCEL_TEAM	no	no	Team slug or id whose charges are exported. Optional: when the token sees exactly one team it is resolved automatically; set this to disambiguate.

Vultr

--provider vultr (Cloud (IaaS))

Grain: invoice line item (product x resource, per invoice); pending charges for the open month. Reads the current month by default; pass --month or --start/--end for another window.

Provider documentation: https://docs.costgraph.ai/costgraph/integrations/vultr

Variable	Required	Secret	Description
VULTR_API_KEY	yes	yes	Vultr API key (Account -> API) of a user with the Billing permission.

xAI

--provider xai (AI / LLM)

Grain: day x model (billed cost). Reads the current month by default; pass --month or --start/--end for another window.

Provider documentation: https://docs.costgraph.ai/costgraph/integrations/xai

Variable	Required	Secret	Description
XAI_MANAGEMENT_KEY	yes	yes	xAI management key (xAI Console -> Settings -> Management Keys). Separate from the inference API key; billing usage requires a management key.
XAI_TEAM_ID	yes	no	Team the charges belong to (xAI Console -> Settings).