---
title: "Purchase additional credits"
method: POST
path: "/api/billing/topup"
tags: ["billing"]
---

# Purchase additional credits

`POST /api/billing/topup`

[cloud-only] Purchases a one-time credit top-up using the user's payment method on file.

## Request body

- object
  - `amount` integer, required — Number of credits to purchase

## Response `200`

Top-up successful

- BillingBalance — [cloud-only] Current credit balance and usage summary.
  - `credits_remaining` integer, required — Available credits
  - `credits_used` integer — Credits used in current billing period
  - `credits_total` integer — Total credits allocated in current period

## Other responses

- `400` — Bad request
- `401` — Unauthorized

## Changes

- **2026-05-08** `c9640fded659` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/comfy-org/apis/comfyui-api/changes/api/billing/topup/post.md)

---

[API](https://skmtc.dev/comfy-org/apis/comfyui-api.md) · [All operations](https://skmtc.dev/comfy-org/apis/comfyui-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/comfy-org/comfyui-api/revisions/2f69d843959c/schema)