> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hostlinku.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Accounts, billing & policies

> Brief answers regarding accounts, payments, fees, and privacy.

## Account and API key

### How do I get started?

[Sign up](https://api.hostlinku.com/api/auth2/register) or [sign in](https://api.hostlinku.com/api/auth2/login), then open [Console](https://console.hostlinku.com). Top up your balance in **Billing** and create a key in **API Keys**. Follow the [Quick Start](https://docs.hostlinku.com/en/getting-started.md).

### What key settings are available?

Select a name, Service Mode **Performance / Economy / Dedicated**, expiration **30/60/90 days or never**, and an optional monthly limit. The default is Performance and 30 days. No scope. The key management API supports additional periods; see [Authentication](https://docs.hostlinku.com/en/authentication.md).

### How are secrets stored?

The secret appears once; the server stores the SHA-256 hash. Store it in the server environment. Keys can be edited, enabled/disabled, and deleted. Replace the key if the secret is lost or leaked.

### Are passkeys and 2FA available?

Yes. **Settings → Security** provides WebAuthn passkeys, TOTP authenticators, and recovery codes via Keycloak.

## Balance and payments

### How does the USD balance work?

The customer balance is denominated directly in USD and used by associated keys. It can only be used for Hostlinku services and is not cash that can be freely spent. Refunds are subject to the [Refund Policy](https://docs.hostlinku.com/en/legals/refund-policy.md).

### How do I top up?

Go to **Billing**, select the amount and payment method. Card/wallet payments (Visa, Mastercard, Apple Pay, Google Pay) use **Waffo**; QRIS/VA payments use **iPaymu**; crypto payments use **Heleket hosted**. The amount, bonus, exchange rate, fees, and deadline are displayed before payment. The USD balance is updated after verification. View [Billing & Balance](https://docs.hostlinku.com/en/billing.md).

### Where are the costs and invoices?

**Logs** display request costs, **Analytics** show usage summaries, and **Billing** lists transactions and invoices. Non-streaming chat includes `hostlinku.cost`; for SSE, check the final cost upon completion. Missing usage can be estimated.

Invoices can be printed or saved as PDFs via the browser. Billing Profiles are stored locally in the Console browser, so Console printouts may differ from invoices generated by Pay or other devices.

### Is there an auto-recharge feature or low-balance email?

Not yet available on active Billing. Monitor your balance and top up before production use. Adding funds does not increase the key limit.

## Error and privacy

### What is the action for a 429 or 402 error?

For 429, wait according to `Retry-After` and use backoff; see [Usage & Limits](https://docs.hostlinku.com/en/usage-and-limits.md). For 402, check available balance and key spending limits; see [Billing & Balance](https://docs.hostlinku.com/en/billing.md).

### Are all failed requests free of charge?

Failure without billable usage releases the reservation. For interrupted streams or partial usage, check the final charges in Logs.

### Are the prompts and responses saved?

Body logging is **disabled by default**; cost metadata, tokens, status, and latency are still logged. When enabled by an admin, the body is size-limited, credential fields are filtered, and the default retention period is 14 days. Secrets in the prompt text are not automatically filtered. See the [Privacy Policy](https://docs.hostlinku.com/en/legals/privacy-policy.md).

### How do I contact support?

Service: [support@hostlinku.com](mailto:support@hostlinku.com). Personal data requests: [support@hostlinku.com](mailto:support@hostlinku.com). Read [Security](https://docs.hostlinku.com/en/legals/security.md) and [Support](https://docs.hostlinku.com/en/support.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.