Docs › Troubleshooting › Usage, billing and network errors

Usage, billing and network errors

Every usage, billing, account and connection card the chat can show, with what it means and what to do.

On this page

When a request fails, the chat shows a card with a title, sometimes a detail, a hint and a Reference line. Find the card's title below. How the allowance works is on Usage and limits; plans and prices are on the pricing page.

Usage limit reached

Cause: your plan's allowance for this period is used up. The card says when it resets.

On a team plan, Ask your team's admin to upgrade or turn on additional usage. Only an admin can.

You have used this month's allowance

You have used this month's free allowance on the Free plan, where upgrading starts your month again straight away. On other plans, open AstraCode Settings > Usage to see when it resets or to turn on additional usage.

Additional usage limit reached

Cause: additional usage reached the monthly limit you set.

  1. Choose Raise the limit.
  2. Pick a higher Monthly limit, or No limit, on the Usage page.

Stopped at your spending cap

Cause: a safety cap was reached, not your plan's allowance. Raise it on the Usage page if that is what you want.

Additional usage will not turn on

MessageWhat to do
Add a valid card in Billing to turn on additional usage.Choose Open Billing, add a card on the site, then Turn on again.
On paid plansThe Free and Student plans cannot have additional usage. Upgrade to a paid plan.
AstraCode did not accept that change to additional usage.Try again. If it repeats, contact support.
Could not reach AstraCode to change additional usage.Check your connection and try again.

Going too fast

The title starts Going too fast and says when to try again, or that it clears on its own. Nothing was charged to your allowance.

Cause: a short rate limit. Wait the time it gives, then send again.

Inline completions are paused until tomorrow

Cause: tab completion's daily limit. Chat and the agent still work. It resets at midnight UTC.

Payment is needed to continue

Cause: the gateway needs a payment on your account before it serves more. The card may carry the gateway's own sentence instead. Open AstraCode Settings > Usage to see your plan and allowance, and Billing on the site for your card.

You are signed out

Cause: your session ended or was refused. Run AstraCode: Sign In. See Sign-in problems.

Your account is not allowed to do that

This card may instead carry the gateway's own sentence, such as a model or feature not enabled for your organisation.

Cause: your organisation's settings do not allow the request. Signing in again will not change this; an owner of your organisation can.

Could not reach AstraCode

The detail says what failed, and the hint says a VPN or corporate network may be blocking api.astracode.io.

DetailWhat it usually means
the secure connection could not be verifiedA VPN, proxy or firewall is inspecting encrypted traffic. Ask for an exception for api.astracode.io and astracode.io, or have the proxy's certificate trusted on this machine.
the server could not be foundNo internet connection, or DNS cannot resolve the address.
the connection was refusedSomething on the network is blocking the connection.
the connection was interruptedThe connection dropped. Send again.
the request timed outThe network is slow or blocking. Send again.
the network is unreachableThis machine has no route to the internet.
  1. Check that the machine is online.
  2. Allow api.astracode.io and astracode.io through your VPN, proxy or firewall. AstraCode has no proxy setting of its own.
  3. If your organisation runs its own gateway, check AstraCode Settings > Browser & Network > Gateway (astracode.gatewayUrl).
  4. Send the message again.

Could not reach AstraCode to load your plan. on the Usage page has the same causes, and fills in by itself once AstraCode answers.

AstraCode is temporarily out of capacity

Cause: a problem on our side, and we are notified. Your work is saved. Try again shortly.

This model is temporarily unavailable, or the model is busy right now

Cause: the model provider is unavailable or overloaded. Nothing was charged. Try again in a moment. With your own key, pick another model.

The model refused this request

Rephrase the request. If it keeps happening, report it with AstraCode: Report a Problem.

That model is out of credit

Cause: the provider refused for billing, not because of anything in your message. With your own key, add credit to that provider account, or pick another model. See Bring your own key.

That model is not available

Cause: the model you pinned is not offered. Pick another model, set Auto, or update AstraCode if the model is new.

This conversation is too long for the model

Compact the session (Compact session in the context ring, or AstraCode: Compact Session), start a new chat, or detach some files. Sending the same message again will not help.

That was too large to send

Detach some files or shorten the message, then send it again.

That message had nothing in it to send

Cause: an attachment on its own is not always enough. Add a line of text and send it again.

AstraCode sent something the gateway could not read

Cause: a bug on our side; retrying the same thing will not help. Choose Report this on the card, then start a new chat or rephrase.

The gateway had a problem

Cause: a fault on our side, not your account or your request. Try again shortly. If it repeats, report it with the Reference from the card.

The request did not go through

Try again. If it keeps happening, choose Report this so the details below the card reach us.

← Dictation problems CLI problems →

All documentation

Get started

Using the editor

Agent

Context

Workspaces

Connectors

Extending AstraCode

CLI

Account and usage

Troubleshooting

Reference