Como criar uma chave de API Grok, além de uma alternativa

Criando uma chave com o fornecedor

Somos um serviço independente e não a API oficial da xAI, então para a chave própria da xAI você precisa das páginas da xAI. O fluxo é comum na maioria dos provedores, e os nomes dos menus podem diferir do que se segue.

1. Entre no console de desenvolvedores do provedor com sua conta.
2. Verifique a seção de faturamento. Alguns provedores exigem um método de pagamento ou um depósito antes que uma chave funcione; leia o que o seu pede.
3. Abra a seção de chaves de API e escolha criar uma nova chave.
4. Dê a ela um nome que indique onde ela será usada, como o projeto ou o ambiente.
5. Copie a chave imediatamente. Muitos consoles mostram o segredo completo apenas uma vez.
6. Armazene-a em um gerenciador de segredos ou em uma variável de ambiente, nunca no código-fonte.

Se o layout da página não corresponder, a documentação do provedor é a autoridade. Qualquer guia escrito há meses, incluindo este, pode descrever uma interface mais antiga.

Obtendo uma chave aqui em menos de um minuto

Nossa chave é para um endpoint compatível com OpenAI que serve um único modelo de pesos abertos hospedado, ajustado para responder sem recusas de conteúdo para uso adulto legal. Obter uma leva cinco etapas.

1. Abra a página da chave de API.
2. Entre com o Google, ou com um e-mail e senha.
3. Clique uma vez para resgatar seus $0,50 de crédito de teste. É um por pessoa, válido por 7 dias, e não precisa de cartão.
4. Copie a chave mostrada na página.
5. Execute a chamada de teste abaixo.

A URL base é https://api.grokaiapikey.com/v1, o ID do modelo é uncensored e a chave vai no cabeçalho Authorization: Bearer.

Teste a chave

Comece com curl. Se isso retornar uma resposta JSON, sua chave, URL base e modelo estão todos corretos.

Copyexport API_KEY="paste-your-key-here"

curl https://api.grokaiapikey.com/v1/chat/completions   -H "Authorization: Bearer $API_KEY"   -H "Content-Type: application/json"   -d '{"model": "uncensored",
       "messages": [{"role": "user", "content": "Reply with the word ready."}]}'

No Node, o pacote oficial OpenAI funciona depois que você altera duas configurações.

Copyimport OpenAI from "openai";

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

const r = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Reply with the word ready." }],
});
console.log(r.choices[0].message.content);

Usuários de Python podem fazer o mesmo com OpenAI(base_url=..., api_key=...). Os métodos disponíveis são POST /v1/chat/completions, POST /v1/responses e GET /v1/models.

Configurando a chave como uma variável de ambiente

Nunca cole uma chave no código-fonte. Coloque-a em uma variável de ambiente e leia-a em tempo de execução. Os comandos variam conforme o sistema.

Copy# macOS or Linux, current shell session
export API_KEY="paste-your-key-here"

# Windows PowerShell, current session
$env:API_KEY = "paste-your-key-here"

# Check that the variable is set (macOS or Linux)
test -n "$API_KEY" && echo "key is set"

Em um projeto, armazene o valor em um .env que esteja listado no .gitignore e carregue-o com o carregador do seu framework. Em um servidor, use o repositório de segredos do host ou as configurações de ambiente da plataforma de implantação. A URL base para este site é https://api.grokaiapikey.com/v1 e é seguro mantê-la no código porque não é um segredo.

Se você executa vários serviços, forneça uma chave própria para cada um. Contas que foram recarregadas podem ter até 5 chaves, então uma cópia de staging, uma de produção e uma chave pessoal de teste podem coexistir, cada uma com seu próprio rótulo.

Se a chamada falhar

Sintoma	Causa provável	Correção
401 Não Autorizado	Chave ausente ou digitada incorretamente	Verifique o cabeçalho Bearer e procure por um espaço ou aspas no final
404 Not Found	URL base incorreta	O caminho deve ser /v1/chat/completions no subdomínio api.
Erro do modelo	Nome do modelo incorreto	Use o ID do modelo uncensored
429 rate_limited	Muitas requisições por minuto	Chaves de teste permitem 60 por minuto; reduza a frequência
429 concurrency	Muitos de uma vez	Chaves de teste permitem 2 em execução; um streaming ocupa sua vaga até o fim

Um 429 com o cabeçalho Retry-After: 5 indica sobrecarga temporária. Aguarde os cinco segundos e tente novamente.

Use o ID da requisição

Toda resposta inclui o cabeçalho X-Request-Id. Registre-o junto à sua própria mensagem de erro. Se você entrar em contato com a equipe de suporte sobre uma chamada falha, o ID da requisição permite que eles localizem exatamente essa chamada em vez de adivinhar. No curl, adicione -i para imprimir os cabeçalhos da resposta e, no SDK Python, você pode lê-los com o helper de resposta bruta.

Quando um problema é intermitente, os cabeçalhos também ajudam: X-RateLimit-Limit-Requests e X-RateLimit-Limit-Concurrency mostram os limites aplicáveis à sua chave, o que permite ver de relance se você está usando uma chave de teste ou uma completa.

Substituindo ou adicionando chaves

Você nunca precisa pedir a ninguém para rotacionar uma chave. Na página da chave de API, você pode regenerar (reemitir) a chave sempre que quiser, e a chave antiga deixa de funcionar imediatamente. Faça isso assim que uma chave cair em um repositório público, uma captura de tela ou um chat compartilhado.

Contas que foram recarregadas podem ter até 5 chaves. Dê um rótulo a cada uma, como staging ou app mobile, e revogue uma única chave sem afetar as outras. Usar uma chave por ambiente é um bom hábito, porque revogar uma chave de staging vazada não afeta seu tráfego de produção.

Usando a chave em ferramentas existentes

Você não precisa escrever código para usar a chave. Muitas interfaces de chat e ferramentas de desenvolvedores aceitam um endpoint compatível com OpenAI personalizado, e o SillyTavern é um exemplo público. A configuração sempre pede os mesmos três valores.

• URL base ou URL da API: https://api.grokaiapikey.com/v1
• Chave de API: a chave que você copiou
• Nome do modelo: uncensored

Algumas ferramentas exigem o caminho completo terminando em /chat/completions; outras o adicionam automaticamente. Se você receber 404, tente a outra forma. Se a lista de modelos da ferramenta permanecer vazia, digite o nome do modelo manualmente ou deixe-a buscar a lista via GET /v1/models, que retorna o único ID do modelo.

O streaming funciona através das mesmas configurações. Se as respostas aparecerem todas de uma vez em vez de palavra por palavra, procure por uma opção de streaming na ferramenta.

Mantendo uma chave segura

• Mantenha no lado do servidor. Uma chave colocada no JavaScript do navegador ou em um pacote de aplicativo móvel pode ser lida por qualquer pessoa.
• Carregue-a de uma variável de ambiente e adicione seu arquivo .env ao .gitignore antes do primeiro commit.
• Defina um hábito de gasto: monitore o cabeçalho de resposta X-Balance-USD para que uma queda inesperada se destaque.
• Use chaves separadas para serviços separados para que você possa revogar uma sem causar uma interrupção.

Depois que a chamada de teste funcionar, leia a documentação sobre streaming, chamada de funções e modo JSON, e veja a página de preços para as tarifas: $0.15 por 1M de tokens de entrada e $0.50 por 1M de tokens de saída. Se você está comparando isso com um fornecedor fechado, nosso artigo sobre por que desenvolvedores mudam para modelos sem censura aborda os prós e contras.

Uma rotina simples de rotação

1. Na página da chave de API, crie ou regenere a chave que deseja substituir. Regenerar faz com que a chave antiga pare de funcionar imediatamente, então faça isso quando seu código estiver pronto para assumir o novo valor.
2. Atualize a variável de ambiente ou o segredo em todos os lugares onde a chave é usada.
3. Reinicie o serviço e execute o teste curl deste artigo.
4. Anote a data em suas anotações. Um lembrete de calendário a cada poucos meses é suficiente para a maioria dos projetos.

Se você possui várias chaves rotuladas após um recarregamento, faça a rotação uma de cada vez. Revogue primeiro a chave vinculada a um laptop ou a um ex-colega, já que essas são as mais propensas a vazarem.

Mais guias

• Chave de API Grok grátis: o que é real e o que é golpe
• Chave de API Claude: Por que os Desenvolvedores Mudam para Modelos Sem Censura