Faturamento

API prepaga da Polar em BRL. Créditos, preços de Urso Mabe e Urso Guto, tiers por volume e gestão de saldo.

Visão Geral

A API pública da Polar funciona em modo prepago:

sua organização adiciona créditos em BRL
o saldo é debitado conforme uso real de tokens
o consumo é consolidado por organização e API key
descontos por volume são aplicados no custo final conforme o tier comercial

Preços por Modelo

Modelos de Linguagem (por 1M tokens)

Modelo	ID versionado	Input	Output
Urso Mabe	`urso-mabe-polaris2-20260329`	R$ 0,50	R$ 1,50
Urso Guto	`urso-guto-polaris2-20260329`	R$ 1,50	R$ 6,00

IDs estáveis aceitos:

urso-mabe
urso-guto

Somente Urso Mabe e Urso Guto fazem parte da API pública. Embeddings, ASR, TTS, Kodiak, Polar Claw e demais superfícies permanecem internas aos produtos Polar.

Tiers por Volume

Tier	Gasto mínimo	Desconto	RPM	TPM
Pay-as-you-go	R$ 0/mês	0%	60	100.000
Growth	R$ 500/mês	10%	300	500.000
Scale	R$ 2.000/mês	20%	1.000	2.000.000
Enterprise	R$ 10.000/mês	30%	5.000	10.000.000

O desconto é aplicado no custo final do consumo, não no saldo comprado.

Recarga de Créditos

Recargas podem ser feitas com cartão, PIX ou boleto via Stripe. Pacotes padrão:

Checkout	Créditos lançados	Observação
R$ 30	R$ 30	entrada
R$ 100	R$ 100	padrão
R$ 500	R$ 525	bônus de R$ 25
R$ 2.000	R$ 2.200	bônus de R$ 200

Também é possível carregar qualquer valor customizado aprovado pelo checkout da organização.

Via painel autenticado

import requests

# Criar sessão de checkout para a organização autenticada
response = requests.post(
    "https://api.polarai.com.br/v1/organization/billing/checkout",
    headers={"Authorization": "Bearer <supabase_jwt>"},
    json={
        "amount_brl": 10000,  # centavos => R$ 100,00
        "success_url": "https://polarai.com.br/billing?success=true",
        "cancel_url": "https://polarai.com.br/billing?cancelled=true"
    }
)

checkout = response.json()
print(checkout["url"])

Auto-Recarga

Configure a recarga automática para nunca ficar sem créditos:

# Configurar auto-recarga
response = requests.put(
    "https://api.polarai.com.br/v1/organization/billing",
    headers={"Authorization": "Bearer <supabase_jwt>"},
    json={
        "auto_recharge_enabled": True,
        "auto_recharge_threshold": 10.0,
        "auto_recharge_amount": 50.0
    }
)

Configurações de Auto-Recarga

Campo	Tipo	Descrição
`auto_recharge_enabled`	boolean	Habilita/desabilita a auto-recarga
`auto_recharge_threshold`	number	Saldo mínimo que dispara a recarga
`auto_recharge_amount`	number	Valor da recarga em BRL
`api_billing_tier`	string	Tier comercial da organização

Consultar Saldo

response = requests.get(
    "https://api.polarai.com.br/v1/organization/billing",
    headers={"Authorization": "Bearer <supabase_jwt>"}
)

balance = response.json()
print(f"Saldo: R$ {balance['balance_brl']:.2f}")
print(f"Tier: {balance['api_billing_tier_name']}")
print(f"Desconto: {balance['api_discount_percent']}%")

Resposta:

{
  "balance_brl": 87.5,
  "auto_recharge_enabled": true,
  "auto_recharge_threshold": 10.0,
  "auto_recharge_amount": 50.0,
  "api_billing_tier": "growth",
  "api_billing_tier_name": "Growth",
  "api_discount_percent": 10,
  "rate_limit_rpm": 300,
  "rate_limit_tpm": 500000
}

Histórico de Transações

response = requests.get(
    "https://api.polarai.com.br/v1/organization/billing/transactions",
    headers={"Authorization": "Bearer <supabase_jwt>"},
    params={
        "limit": 20,
        "offset": 0
    }
)

transactions = response.json()
for tx in transactions["data"]:
    print(f"[{tx['created_at']}] {tx['type']}: R$ {tx['amount']:.2f} — {tx['description']}")

Resposta:

{
  "data": [
    {
      "id": "tx_abc123",
      "type": "credit",
      "amount": 50.00,
      "balance_after": 87.50,
      "description": "Recarga via cartão de crédito",
      "created_at": "2024-03-15T10:30:00Z"
    },
    {
      "id": "tx_def456",
      "type": "debit",
      "amount": -0.12,
      "balance_after": 37.50,
      "description": "Chat Completions — urso-guto — 12K tokens",
      "created_at": "2024-03-15T10:25:00Z"
    }
  ],
  "has_more": true
}

Endpoints de Billing

Endpoint	Método	Descrição
`/v1/organization/billing`	GET	Saldo, tier, modelos públicos e pacotes
`/v1/organization/billing`	PATCH	Atualiza auto-recarga e tier da organização
`/v1/organization/billing/checkout`	POST	Cria sessão Stripe para recarga
`/v1/organization/billing/transactions`	GET	Extrato de créditos
`/v1/organization/usage`	GET	Uso detalhado por modelo e período
`/v1/organization/api-keys`	GET/POST	Gerencia API keys da organização

Limites

Valor mínimo de recarga: R$ 5,00
Valor máximo de recarga por transação: R$ 10.000,00
Auto-recarga mínima: R$ 10,00
Créditos não expiram

On this page