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

# Stars — a moeda do Apollo Space

> Como funciona o saldo da sua organização: Stars, créditos mensais, pacotes avulsos e onde o saldo é consumido.

## O que são Stars

**Stars (★)** são a moeda interna do Apollo Space. Toda ação cobrável —
uma busca pública, um e-mail enviado, uma mensagem de WhatsApp, uma
execução de tool externa — consome Stars da carteira da sua
organização.

Em vez de você reconciliar custos heterogêneos de cada vendor (LLM
em tokens, Twilio em centavos por país, Tavily por chamada), o
Apollo Space entrega uma única unidade pra acompanhar o uso da plataforma.

## A carteira tem dois compartimentos

<Tabs>
  <Tab title="Mensal (renova todo mês)">
    <Card title="Crédito recorrente da assinatura" icon="calendar">
      Incluído no seu **plano de assinatura**. Renova automaticamente
      todo mês junto com a cobrança do plano.
    </Card>

    <Warning>
      O saldo mensal **expira** no fim do período — o que não foi
      consumido não passa pro mês seguinte. Ele existe para cobrir o
      uso típico do mês, não para acumular.
    </Warning>

    **Quando usar:** cobre o uso previsível e recorrente da operação do time.
  </Tab>

  <Tab title="Pacote (rollover, não expira)">
    <Card title="Crédito avulso comprado a qualquer momento" icon="box">
      Comprado de forma **pontual** (top-up) em Settings → Faturamento.
      Disponível em diferentes tamanhos — quanto maior o pacote, melhor
      a relação por Star.
    </Card>

    <Info>
      O saldo de pacote **não expira** — fica disponível até ser
      consumido, independente de renovações de plano ou cancelamentos.
    </Info>

    **Quando usar:** picos sazonais, colchão de segurança, ou uso do
    Apollo Space sem assinatura mensal ativa.
  </Tab>
</Tabs>

<Note>
  **Ordem de consumo:** quando uma chamada acontece, o Apollo Space debita
  **primeiro do Mensal** (porque expira) e só depois do Pacote.
  Você vê o saldo separado por compartimento na aba **Faturamento**
  das configurações da org.
</Note>

## Onde os Stars são consumidos

Toda vez que um agente aciona uma capacidade com custo subjacente:

| Categoria                 | Exemplos                                                                      |
| ------------------------- | ----------------------------------------------------------------------------- |
| **LLM**                   | Tokens dos modelos de linguagem — toda conversa com agente passa por aqui     |
| **Busca pública**         | Pesquisas web feitas pelo [Scout](/agents/scout)                              |
| **Outbound**              | WhatsApp e SMS via [Twilio](/integrations/whatsapp)                           |
| **Enrichment + scraping** | Actors do [Apify](/integrations/apify) — busca em mapas, contatos de site     |
| **Integrações externas**  | Tools do [Composio](/integrations/composio) que cobram (a maioria é gratuita) |

A tabela de preços atualizada fica em **Faturamento → Uso por
categoria** dentro do app. Valores podem mudar conforme acordos com
os vendors — sempre comunicados com antecedência.

## Como Apollo Space protege seu orçamento

Antes de cada chamada cobrável, o Apollo Space verifica em **múltiplos
níveis** se a ação cabe no orçamento da org:

```mermaid theme={null}
flowchart TD
    A[Agente quer fazer ação cobrável] --> B{Saldo da carteira > 0?}
    B -->|Não| Z1[Bloqueia: saldo insuficiente]
    B -->|Sim| C{Cap da org OK?}
    C -->|Estoura| Z2[Bloqueia: cap da org]
    C -->|OK| D{Cap do agente OK?}
    D -->|Estoura| Z3[Bloqueia: cap do agente]
    D -->|OK| E{Cap do usuário OK?}
    E -->|Estoura| Z4[Bloqueia: cap do usuário]
    E -->|OK| F[Executa ação]
    F --> G[Debita do compartimento Mensal primeiro]
    G --> H[Se necessário, debita do Pacote]
    H --> I[Registra no histórico append-only]
```

<CardGroup cols={2}>
  <Card title="Saldo da carteira" icon="wallet">
    Se a carteira está zerada, nenhuma nova chamada cobrável é
    autorizada — independente do agente ou usuário.
  </Card>

  <Card title="Caps configuráveis" icon="gauge-high">
    Você pode definir **tetos de gasto** por organização, por agente
    e por usuário. Ao atingir o teto, o Apollo Space bloqueia novas
    chamadas naquela dimensão sem afetar as outras.
  </Card>
</CardGroup>

O detalhe de cada nível de cap está em [Caps de gasto](/billing/caps).

## BYO-key — você é dono da conta no vendor

Para a maioria dos vendors externos (Tavily, Twilio, Apify), você
conecta a **sua própria conta**. Por quê:

* A **fatura real** do vendor vai direto pra você — Apollo Space não é
  intermediário de pagamento
* Você mantém controle das suas credenciais e pode revogar a
  qualquer momento
* O débito em Stars dentro do Apollo Space é o **contador interno** —
  serve pros caps e pra te dar visão unificada do consumo

Em resumo: você nunca depende do crédito da Apollo Space pra usar os
vendors externos.

## Histórico e auditoria

Todo movimento na carteira — crédito recebido, débito por uso,
ajuste manual — gera uma linha no histórico, **append-only**. Nada é
deletado ou editado retroativamente.

Resultado: você responde "o que aconteceu com meu saldo no dia X?"
com precisão a qualquer momento.

O histórico é **isolado por organização** — ninguém de outra org vê
o seu, nem operadores internos do Apollo Space sem privilégio explícito.
Veja [Multi-tenant](/trust/multi-tenant) pro modelo de isolamento.

## Refunds e ajustes

* **Refunds** (cobrança disputada, plano cancelado retroativo) são
  processados automaticamente quando o evento chega pela Stripe
* **Ajustes manuais** (bônus de boas-vindas, crédito promocional,
  remediação de incidente) são feitos pelo time de suporte com
  rastro completo no histórico

## Próximos passos

<CardGroup cols={2}>
  <Card title="Planos e pacotes" icon="box" href="/billing/plans-and-packs">
    Visão geral dos planos disponíveis + como comprar packs.
  </Card>

  <Card title="Caps de gasto" icon="gauge-high" href="/billing/caps">
    Como configurar tetos por org, por agente ou por usuário.
  </Card>

  <Card title="Multi-tenant" icon="shield-check" href="/trust/multi-tenant">
    Como o saldo é isolado entre organizações.
  </Card>

  <Card title="Integrações" icon="puzzle-piece" href="/integrations/composio">
    O que se conecta + o que cai (ou não) no saldo.
  </Card>
</CardGroup>
