Get Project Cost
Retrieve current billing period cost breakdown for a project.
Authorizations
Service Account Token authentication. To authenticate API requests:
-
Create a Service Account Token:
- Go to the Cerebrium Dashboard and open the API Keys page
- Click Create Service Account, name it (e.g., "GitHub Actions CI/CD"), choose an expiry date, and click Create
- Copy the token generated for the desired service account
-
Use the Token: Include the service account token in the Authorization header of API requests:
Authorization: Bearer <your-service-account-token> -
Best Practices:
- Create separate service accounts for different environments (dev, staging, prod)
- Store tokens securely as secrets in consuming applications or workflows
- Set appropriate expiry dates and rotate tokens regularly
- Never commit tokens to source control
For CI/CD integration examples, see the CI/CD documentation.
Path Parameters
Query Parameters
Month to retrieve costs for, in YYYY-MM format. Defaults to the current month.
Response
Cost breakdown for the project for the requested month.
Per-app usage breakdown from billing. Each item has app_name (string), cpu_cost_cents, cpu_seconds, gpu_cost_cents, gpu_seconds, memory_cost_cents, memory_seconds, and total_cost_cents fields.
Per-app cost metrics for the month. Each item includes the app identifier with its CPU, GPU, and memory cost and usage figures.
Coupons applied to the account. Each item has coupon_name (string), amount_cents (integer), and amount_cents_remaining (integer) fields.
Aggregated cost totals for the month, including compute cost and usage totals in cents and seconds, build cost totals, coupon discounts, and combined totals before and after discounts.