> ## Documentation Index
> Fetch the complete documentation index at: https://x-preview-mintlify-cb0fe90e.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Preços

> A X API utiliza um modelo de preços por uso. Sem assinaturas—pague apenas pelo que usar. Ganhe créditos gratuitos da xAI API ao comprar créditos da X API—até 20% de volta.

export const Button = ({href, children}) => {
  return <div className="not-prose group">
    <a href={href}>
      <button className="flex items-center space-x-2.5 py-1 px-4 bg-primary-dark dark:bg-white text-white dark:text-gray-950 rounded-full group-hover:opacity-[0.9] font-medium">
        <span>
          {children}
        </span>
        <svg width="3" height="24" viewBox="0 -9 3 24" class="h-6 rotate-0 overflow-visible"><path d="M0 0L3 3L0 6" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round"></path></svg>
      </button>
    </a>
  </div>;
};

A X API utiliza preços **por uso**. Sem assinaturas—pague apenas pelo que usar.

<Button href="https://developer.x.com/#pricing">Ver preços e comprar créditos</Button>

***

## Como funciona

<CardGroup cols={2}>
  <Card title="Baseado em créditos" icon="coins">
    Compre créditos antecipadamente no Developer Console. Os créditos são deduzidos conforme você faz requisições à API.
  </Card>

  <Card title="Preços por endpoint" icon="code">
    Endpoints diferentes têm custos diferentes. Veja as tarifas atuais no Developer Console.
  </Card>

  <Card title="Sem compromissos" icon="unlock">
    Sem contratos, assinaturas ou gasto mínimo. Comece e pare quando quiser.
  </Card>

  <Card title="Monitoramento em tempo real" icon="gauge-high">
    Acompanhe o uso e os custos ao vivo no Developer Console.
  </Card>
</CardGroup>

<Tip>
  Ganhe créditos gratuitos da [xAI API](https://docs.x.ai) ao comprar créditos da X API—até 20% de volta com base no seu gasto. [Saiba mais](#free-xai-api-credits)
</Tip>

***

## Detalhes do consumo de créditos

Todos os preços são por recurso obtido (leituras) ou por requisição (escritas/ações). [Compre créditos](https://console.x.com) no Developer Console.

### Operações de leitura

Cobradas por recurso retornado na resposta.

| Recurso                       | Custo Unitário      |
| :---------------------------- | :------------------ |
| **Posts: Read**               | \$0.005 por recurso |
| **User: Read**                | \$0.010 por recurso |
| **DM Event: Read**            | \$0.010 por recurso |
| **Following/Followers: Read** | \$0.010 por recurso |
| **List: Read**                | \$0.005 por recurso |
| **Space: Read**               | \$0.005 por recurso |
| **Community: Read**           | \$0.005 por recurso |
| **Note: Read**                | \$0.005 por recurso |
| **Media: Read**               | \$0.005 por recurso |
| **Analytics: Read**           | \$0.005 por recurso |
| **Trend: Read**               | \$0.010 por recurso |

### Operações de escrita

Cobradas por requisição.

| Ação                           | Custo Unitário         |
| :----------------------------- | :--------------------- |
| **Content: Create**            | \$0.015 por requisição |
| **Content: Create (with URL)** | \$0.200 por requisição |
| **DM Interaction: Create**     | \$0.015 por requisição |
| **User Interaction: Create**   | \$0.015 por requisição |
| **Interaction: Delete**        | \$0.010 por requisição |
| **Content: Manage**            | \$0.005 por requisição |
| **List: Create**               | \$0.010 por requisição |
| **List: Manage**               | \$0.005 por requisição |
| **Bookmark**                   | \$0.005 por requisição |
| **Media Metadata**             | \$0.005 por requisição |
| **Privacy: Update**            | \$0.010 por requisição |
| **Mute: Delete**               | \$0.005 por requisição |
| **Counts: Recent**             | \$0.005 por requisição |
| **Counts: All**                | \$0.010 por requisição |

<Note>
  Os preços estão sujeitos a alterações. As tarifas atuais estão sempre disponíveis no [Developer Console](https://console.x.com) e na [página de preços do developer.x.com](https://developer.x.com/#pricing).
</Note>

***

## Owned Reads

Owned Reads são requisições feitas pelo seu próprio aplicativo de desenvolvedor para os seus próprios dados (posts, bookmarks, seguidores, curtidas, listas e mais). Esses endpoints custam **\$0.001 por recurso** (1.000 recursos por \$1).

Os seguintes endpoints se qualificam para o preço de Owned Read quando `{id}` corresponde ao usuário autenticado e esse usuário é o proprietário do aplicativo de desenvolvedor:

| Endpoint                             | Descrição                       |
| :----------------------------------- | :------------------------------ |
| `GET /2/users/{id}/tweets`           | Seus próprios posts             |
| `GET /2/users/{id}/mentions`         | Suas menções                    |
| `GET /2/users/{id}/liked_tweets`     | Posts que você curtiu           |
| `GET /2/users/{id}/bookmarks`        | Seus bookmarks                  |
| `GET /2/users/{id}/followers`        | Seus seguidores                 |
| `GET /2/users/{id}/following`        | Contas que você segue           |
| `GET /2/users/{id}/blocking`         | Contas que você bloqueou        |
| `GET /2/users/{id}/muting`           | Contas que você silenciou       |
| `GET /2/users/{id}/owned_lists`      | Listas que você possui          |
| `GET /2/users/{id}/followed_lists`   | Listas que você segue           |
| `GET /2/users/{id}/list_memberships` | Listas das quais você participa |
| `GET /2/users/{id}/pinned_lists`     | Suas listas fixadas             |

<Tip>
  Os Owned Reads tornam significativamente mais barato construir aplicativos que trabalham com os dados do próprio usuário, como aplicativos de dashboard, análises pessoais ou ferramentas de gerenciamento de conta.
</Tip>

***

## Deduplicação

Todos os recursos são deduplicados dentro de uma janela de **dia de 24 horas em UTC**. Se você solicitar e for cobrado por um recurso (como um Post), solicitar o mesmo recurso novamente dentro dessa janela não gerará uma cobrança adicional.

Isso significa que:

* Solicitar o mesmo Post várias vezes em um dia conta como uma única cobrança
* A janela de deduplicação é reiniciada à meia-noite UTC
* Isso se aplica a todos os recursos faturáveis (Posts, usuários, etc.)

<Note>
  A deduplicação é uma **garantia flexível**. Embora ocorra na grande maioria dos casos, podem existir casos específicos, como interrupções de serviço, em que os recursos não sejam deduplicados.
</Note>

***

## Saldo de créditos

O seu saldo de créditos é exibido no Developer Console. Os créditos são deduzidos em tempo real conforme você faz requisições à API.

<Warning>
  Monitore seu saldo de créditos regularmente para evitar interrupções no serviço. Adicione créditos antes que seu saldo chegue a zero para garantir acesso ininterrupto à API.

  ***Observação:** É possível que o saldo de créditos de uma conta fique ligeiramente negativo. Nesse caso, as requisições à API serão bloqueadas até que você adicione créditos para cobrir o saldo negativo.*
</Warning>

### Recarga automática

Ative a recarga automática para reabastecer seu saldo de créditos automaticamente e evitar interrupções no serviço. Configure isso no Developer Console:

| Configuração              | Descrição                                                                         |
| :------------------------ | :-------------------------------------------------------------------------------- |
| **Valor da recarga**      | O valor a ser adicionado quando a recarga automática for acionada (ex.: \$25)     |
| **Limite de acionamento** | A recarga automática é ativada quando seu saldo cai abaixo deste valor (ex.: \$5) |

<Note>
  A recarga automática exige um método de pagamento salvo definido como padrão. Você pode cancelar a qualquer momento no Developer Console ou entrando em contato com o suporte.
</Note>

***

### Limites de gastos

Defina um valor máximo que você pode gastar por ciclo de cobrança para controlar os custos. Quando o limite for atingido, as requisições à API serão bloqueadas até o próximo ciclo de cobrança.

| Opção                | Descrição                                                                         |
| :------------------- | :-------------------------------------------------------------------------------- |
| **Limite de gastos** | Defina um valor específico em dólares como seu gasto máximo por ciclo de cobrança |

<Tip>
  Use limites de gastos para evitar cobranças inesperadas, especialmente durante o desenvolvimento e os testes.
</Tip>

***

## Créditos gratuitos da xAI API

Ao comprar créditos da X API, você pode ganhar créditos gratuitos da [xAI API](https://docs.x.ai) com base no seu gasto acumulado durante um ciclo de cobrança.

<Note>
  Para receber créditos gratuitos da xAI, você deve vincular sua equipe da xAI à sua conta de desenvolvedor da X. Você pode fazer isso visitando as configurações da sua conta no [developer console](https://console.x.com).
</Note>

### Como funciona

Seu gasto acumulado é monitorado ao longo de cada ciclo de cobrança. À medida que você ultrapassa os limiares de gastos, desbloqueia taxas de recompensa mais altas. Quando um novo ciclo de cobrança começa, seu gasto acumulado é redefinido para \$0.

| Gasto acumulado | Taxa |
| :-------------- | :--- |
| \$0 – \$199     | 0%   |
| \$200 – \$499   | 10%  |
| \$500 – \$999   | 15%  |
| \$1,000+        | 20%  |

<Note>
  A taxa se aplica ao seu **saldo acumulado total**, mas você recebe apenas a diferença—o que é recém-devido menos o que já foi creditado.
</Note>

### Exemplo

Suponha que você faça várias compras ao longo de um ciclo de cobrança:

| Compra      | Taxa | Total devido | Já creditado | Você recebe |
| :---------- | :--- | :----------- | :----------- | :---------- |
| \$100       | 0%   | \$0          | \$0          | **\$0**     |
| \$100       | 10%  | \$20         | \$0          | **\$20**    |
| \$150       | 10%  | \$35         | \$20         | **\$15**    |
| \$150       | 15%  | \$75         | \$35         | **\$40**    |
| \$250       | 15%  | \$112.50     | \$75         | **\$37.50** |
| \$250       | 20%  | \$200        | \$112.50     | **\$87.50** |
|             |      |              |              |             |
| **\$1,000** |      |              |              | **\$200**   |

Este é o mesmo valor que você receberia de uma única compra de \$1,000—a ordem e o tamanho das compras não afetam o total das suas recompensas.

<Tip>
  Veja seu saldo de créditos da xAI e gerencie sua conta em [console.x.ai](https://console.x.ai). Para mais detalhes sobre a cobrança da xAI API, consulte a [documentação de cobrança da xAI](https://docs.x.ai/docs/key-information/billing).
</Tip>

***

## Monitorando o uso

Acompanhe o uso da sua API de forma programática com o [endpoint de Usage](/x-api/usage/introduction):

```bash theme={null}
curl "https://api.x.com/2/usage/tweets" \
  -H "Authorization: Bearer $BEARER_TOKEN"
```

Isso retorna a contagem diária de consumo de Posts, ajudando você a:

* Acompanhar o consumo em relação ao seu orçamento
* Configurar alertas ao se aproximar dos limites
* Identificar endpoints de alto consumo
* Gerar relatórios de uso

***

## Próximos passos

<CardGroup cols={2}>
  <Card title="Developer Console" icon="grid-2" href="https://console.x.com">
    Compre créditos e veja os preços atuais.
  </Card>

  <Card title="Usage API" icon="chart-line" href="/x-api/usage/introduction">
    Monitore o uso de forma programática.
  </Card>
</CardGroup>