Criando uma chave de API aqui em vez de uma chave Grok

Primeiro, o que esta chave é e não é

Uma chave deste site abre exatamente uma coisa: a API em https://api.grokkey.com/v1. Ela não funciona nos endpoints da xAI, e uma chave de qualquer outro fornecedor não funciona aqui. O serviço não é a API oficial da xAI, OpenAI, Meta, Mistral, Qwen, DeepSeek, Google ou Anthropic, e não é um roteador que encaminha sua solicitação para essas empresas.

O que você obtém é uma API de texto compatível com OpenAI com um único ID de modelo, uncensored, ajustada para responder sem recusas de conteúdo para uso adulto legal. Se você precisa de uma chave para o Grok em si, use o console e a documentação próprios da xAI. Se quiser um modelo hospedado para ficção, roleplay, aplicativos de companheiro ou trabalho com texto direto sem camada de recusa, continue lendo.

Etapas: do cadastro a uma chave funcional

1. Abra a página da chave. Vá para a página da chave de API e faça login com Google, ou com um e-mail e senha.
2. Resgate o teste. Após o login, um único clique nessa página concede a você $0,50 de crédito de teste grátis. É um por pessoa, válido por 7 dias e não precisa de cartão.
3. Copie a chave. Ela é exibida na mesma página. Trate-a como uma senha.
4. Guarde-o fora do seu código. Coloque-o em uma variável de ambiente, por exemplo export API_KEY="paste-your-key-here".
5. Faça uma chamada de teste. Use um dos snippets abaixo. Uma resposta significa que a chave funciona.

O caminho inteiro leva alguns minutos, e nenhuma das etapas envolve um projeto, um perfil de faturamento ou uma configuração de console. Uma vez que o crédito de teste se esgote, você recarrega com crédito pré-pago (veja a seção de faturamento abaixo).

Teste a chave com curl

Copycurl https://api.grokkey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Say hello in five words."}]
  }'

Se a chave for válida, você recebe uma conclusão JSON. Observe também os cabeçalhos de resposta: X-Balance-USD mostra seu crédito restante, e X-Request-Id é útil ao entrar em contato com suporte sobre uma requisição específica. Você também pode verificar o saldo diretamente com GET /v1/balance.

Copycurl https://api.grokkey.com/v1/balance \
  -H "Authorization: Bearer $API_KEY"

Chame-o do Python ou Node

Qualquer SDK OpenAI funciona depois que você altera a URL base e a chave. Em Python:

Copyimport os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.grokkey.com/v1",
    api_key=os.environ["API_KEY"],
)

stream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Give me three names for a fantasy tavern."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="")

E no Node com o pacote oficial openai:

Copyimport OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.grokkey.com/v1",
  apiKey: process.env.API_KEY,
});

const res = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Give me three names for a fantasy tavern." }],
});
console.log(res.choices[0].message.content);

O streaming usa eventos enviados pelo servidor e relata o consumo no final. Chamada de funções, modo JSON e os parâmetros de amostragem habituais também funcionam. Detalhes estão na página de documentação.

Em um front-end de chat

Se você não pretende escrever código, muitos front-ends de chat e roleplay aceitam um provedor compatível com OpenAI. O SillyTavern, por exemplo, permite que você adicione um endpoint compatível com OpenAI. A configuração é a mesma de três campos em qualquer aplicativo desse tipo: a URL base https://api.grokkey.com/v1, sua chave e o nome do modelo uncensored. Alguns aplicativos pedem que você escolha um modelo de uma lista; se a lista estiver vazia, digite o nome manualmente ou busque-o com GET /v1/models.

Depois que o teste de conexão for aprovado, o aplicativo envia as mesmas solicitações dos snippets acima. O streaming é suportado, então as respostas aparecem palavra por palavra. Se o aplicativo tiver um campo para tamanho do contexto, 100.000 tokens é a janela, compartilhada entre prompt e resposta.

Como esta chave difere de uma chave de console de fornecedor

Os consoles dos fornecedores variam, então verifique a documentação de cada um para os detalhes atuais. Algumas diferenças são específicas deste serviço e podemos afirmá-las com confiança.

• Reemissão por conta própria. Na página da chave de API, você pode regenerar sua chave quando quiser. A chave antiga deixa de funcionar imediatamente. Você não precisa entrar em contato com ninguém para substituir uma chave que vazou.
• Várias chaves após um recarregamento. Contas que foram recarregadas podem ter até 5 chaves, atribuir um rótulo a cada uma (um por aplicativo ou ambiente, por exemplo) e revogar qualquer uma delas.
• Um modelo, um nome. Não há um catálogo de modelos para escolher. Todas as chamadas usam uncensored, e GET /v1/models o lista.
• Pré-pago, não pós-pago. O crédito é carregado primeiro e consumido por token. Solicitações falhas ou recusadas não são cobradas, e o crédito nunca expira.

A chave de teste é limitada a 2 requisições simultâneas e 60 requisições por minuto. Uma chave completa (após um recarregamento) permite 8 requisições simultâneas e 300 requisições por minuto. Se você exceder um limite, a API retorna HTTP 429 com o código de erro rate_limited ou concurrency, então uma simples nova tentativa com uma breve pausa é a resposta adequada.

Faturamento após o teste

O preço é $0,15 por 1M de tokens de entrada e $0,50 por 1M de tokens de saída. O crédito de teste de $0,50, portanto, compra cerca de 3,33 milhões de tokens de entrada ou 1 milhão de tokens de saída, ou uma mistura dos dois. Uma requisição com 2.000 tokens de entrada e 500 tokens de saída custa $0,00055, então o teste cobre cerca de 909 delas, o suficiente para construir e testar uma ferramenta pequena.

Quando estiver pronto para continuar, recarregue qualquer valor inteiro de $20 a $500, com bônus de +5% a partir de $50, +10% a partir de $100 e +15% a partir de $200. O pagamento é apenas em cripto, USDT na TRC20 ou USDC na Base. A página de preços tem os detalhes. Se você está comparando isso com uma chave Claude, o artigo sobre chave de API Claude versus GrokKey cobre essa comparação.

Mantendo sua chave segura

Uma chave de API é uma credencial bearer: quem a detém pode gastar seu saldo. Alguns hábitos a mantêm fora de problemas.

• Mantenha-a fora do controle de origem. Carregue-a de uma variável de ambiente ou de um gerenciador de segredos, e adicione qualquer arquivo local .env ao .gitignore.
• Nunca a envie para um navegador. Se uma página da web chamar a API diretamente, qualquer pessoa pode ler a chave da página. Coloque um pequeno servidor próprio entre a página e a API e mantenha a chave lá.
• Use uma chave por aplicativo. Após um recarregamento, você pode criar até 5 chaves e atribuir um rótulo a cada uma, como o nome do aplicativo ou do ambiente. Quando uma é mal utilizada, você a revoga sem perturbar as demais.
• Observe o cabeçalho de saldo. Uma queda repentina em X-Balance-USD que você não consegue explicar é o primeiro sinal de uma chave vazada. Regere imediatamente na página da chave, e a chave antiga deixa de funcionar imediatamente.
• Redigir logs. Se você registrar cabeçalhos de requisição, oculte a linha Authorization.

Os prompts enviados pela API não são usados para treinamento, mas isso não torna uma chave vazada inofensiva. Trate a chave como trataria uma senha de banco de dados.

Problemas comuns

401 ou chave inválida

Verifique se o cabeçalho lê Authorization: Bearer seguido pela chave, sem aspas ou espaços extras, e que você está enviando para api.grokkey.com e não para o host de outro fornecedor. Se você regenerou a chave, o valor antigo não funciona mais.

Modelo não encontrado

O único ID de modelo é uncensored. Nomes de outros fornecedores não são válidos aqui.

Erros 429 durante os testes

Na chave de teste, 2 requisições simultâneas é o limite. Uma requisição em streaming mantém seu slot até o fim do stream, então dois streams abertos mais uma terceira chamada serão rejeitados. Aguarde um terminar e tente novamente.

Respostas lentas ou cortadas

Gerações longas levam tempo. Use stream: true para que o texto apareça conforme é produzido, e defina um tempo limite do cliente que se adapte ao comprimento que você solicita. A conclusão pode usar o restante da janela de 100.000 tokens, e max_tokens é opcional, então defina-o quando quiser limitar o comprimento você mesmo.

Mais guias

• Preços de Chave de API: Planos Gratuitos vs Pagamento por Token
• Chave de API Claude vs. GrokKey: A Alternativa Sem Censura