Início rápido: obtenha sua chave de API

Seu painel pessoal: um saldo compartilhado, até 3 chaves de API, códigos de marketplace e o consumo por requisição. No bot do Telegram e em app.oneprovider.dev.

Como funciona

• O saldo e as chaves ficam no seu painel pessoal. É o mesmo painel no bot e no site.
• Você recarrega um único saldo compartilhado e emite as chaves de API por conta própria (3 por padrão; o suporte pode aumentar o limite). Cada chave gasta esse saldo dentro do seu próprio limite.
• Uma chave antiga é movida para o painel, com o saldo restante, quando você abre o bot.

Abra o painel

Entrar no painel e usar a sua chave de API são coisas diferentes: a chave de API continua sendo a credencial bearer das requisições à API, enquanto o login serve apenas para gerenciar o saldo e as chaves.

Recarregue o saldo

1. Bot: “Painel” → “Recarregar painel”. Site: “Saldo” → “Recarregar”.
2. Escolha um pacote ou um valor livre de US$ 100 a US$ 5.000 e uma forma de pagamento: cripto, cartões internacionais / Apple Pay / Google Pay, SBP / QR. O valor final e as taxas aparecem antes de você pagar.
3. Pague pelo link ou pela fatura. O saldo é creditado automaticamente, em geral em 1 a 3 minutos.

• SBP/QR. O cliente paga uma taxa de 3,5%; a OneProvider cobre outros 3,5%.
• Cripto. Há uma taxa de 3% do provedor, mais a taxa de rede paga pelo cliente.

Os preços dos pacotes estão na página de preços ; as formas de pagamento, em formas de pagamento . O saldo não expira, e não há assinatura nem cobrança automática. Pagou, mas o saldo não mudou? Envie o comprovante para @Oneproviderhelpbot .

Código de marketplace

Comprou na G2A, Plati, G2G ou similar? Seu pedido veio com um código como OP-XXXX-XXXX. Bot: “Mais” → “Ativar código”. Site: “Saldo” → campo “Código OP”. O valor do pedido vai direto para o saldo do painel; a chave você emite por conta própria (próximo passo).

Emita uma chave

1. Bot: “Painel” → “Emitir chave”. Site: “Chaves” → “Emitir uma chave”.
2. Defina um nome (por exemplo, o do cliente), um limite de gastos (ou “sem limite”) e um prazo: até 90 dias, prorrogável depois.
3. Copie a chave na hora: a chave completa é exibida uma única vez e, depois, só por “Mostrar”, após entrar de novo.

Use uma chave separada por cliente ou projeto: assim você vê quem gasta quanto, e uma chave pode ser interrompida sem mexer nas outras. Por padrão, você pode ter 3 chaves (o suporte pode aumentar o limite a pedido); se o limite for atingido, exclua uma — o saldo dela já está no painel, nada se perde.

Formato da chave

As chaves são sk- seguido de 64 caracteres hexadecimais minúsculos — por exemplo sk-50e20199...f837fca1. Trate o valor como opaco: nada dentro dele pode ser interpretado.

Onde guardar

• Desenvolvimento local: uma variável de ambiente no rc do seu shell ou um arquivo .env incluído no .gitignore.
• CI: o cofre de segredos da plataforma (secrets do GitHub Actions, variáveis do GitLab CI etc.).
• Produção: um gerenciador de segredos de verdade — 1Password, AWS Secrets Manager, Doppler, Vault.
• Celular / navegador: nunca. A chave deve ficar atrás de um proxy de servidor que você controla.

Consumo e saldo

A página “Consumo” do painel lista cada requisição com o modelo, os tokens e o preço, com filtro por chave. A API também retorna o saldo: GET /v1/dashboard/balance .

Bônus

O bônus de boas-vindas e o bônus da primeira recarga são ofertas promocionais: podem estar disponíveis por tempo limitado, não podem ser sacados e não são reembolsáveis (veja os Termos ). As ofertas disponíveis aparecem no painel; depois que uma oferta expira, o bônus não pode mais ser resgatado.

Indicações

A aba “Indicações” do painel guarda o seu link pessoal. Convide outras pessoas e receba uma recompensa nas condições exibidas no painel. Cadastrar-se pelo seu próprio link não gera recompensa.

União de painéis

Se você tem dois painéis (por exemplo, um no Telegram e outro no site), escreva para @Oneproviderhelpbot : depois que você comprovar a titularidade dos dois, nós os unimos e o saldo e as chaves ficam em um só painel.

Pausar, excluir, vazamentos

• Pausar interrompe uma chave sem excluí-la; “Reativar” a liga de novo.
• Excluir desativa a chave na hora e não pode ser desfeito. O saldo continua no painel.

Ativação de um código de marketplace: dúvidas

Onde digito o código OP-XXXX-XXXX?

No bot do Telegram, escolha “Mais” → “Ativar código”. Em app.oneprovider.dev, abra “Saldo” e use o campo “Código OP”. O valor do pedido é adicionado ao saldo do seu painel; depois, emita uma chave no passo “Emita uma chave” acima.

Estou ativando em redeem.oneprovider.dev. Qual aba uso?

“Novo usuário” cria uma nova chave a partir do código e do usuário ou e-mail do seu pedido. “Usuário com chave” adiciona o saldo do código a uma chave sk- antiga que você já tem. Um segundo código no mesmo e-mail não cria outra chave nova: use “Usuário com chave” ou outro e-mail.

Não copiei a chave depois da ativação

Digite o mesmo código de novo na página de ativação: ela mostra a chave outra vez, atrás de um clique para exibir. As chaves emitidas no painel podem ser exibidas por “Mostrar” depois que você entrar novamente.

“We couldn’t find this code”

Confira se há erro de digitação nos caracteres (o código é OP- seguido de dois grupos de quatro). Um código revogado ou de outra pessoa também não é encontrado. Tente de novo em outro navegador e, depois, escreva para o suporte com o ID do seu pedido no marketplace.

Posso pedir reembolso de um código?

Em geral, por meio de uma disputa no marketplace onde você comprou. Nossas próprias regras estão na Política de reembolso .