Início rápido para usuários do Unhinged Grok
Conecte seu SDK existente do OpenAI à nossa API de LLM sem censura em cinco minutos atualizando a URL base e a chave de API. Este guia mostra como enviar sua primeira requisição usando código de cliente padrão.
Autenticação e URL Base
Nossa API é compatível com OpenAI, o que significa que você não precisa de uma nova biblioteca. Você só precisa atualizar dois valores na sua configuração existente: o base_url e o api_key. Sua chave de API é gerada imediatamente após o cadastro via Google ou e-mail. Mantenha esta chave segura; ela é a única credencial necessária para autenticação.
Substitua a URL base padrão do OpenAI pelo nosso endpoint. Esta alteração direciona todas as requisições subsequentes para os servidores do nosso modelo sem censura. Nenhuma outra alteração de código é necessária para geração de texto básica.
Exemplo de Configuração
- URL Base:
https://api.unhingedgrok.com/v1 - Chave de API: Sua chave exclusiva no painel
Verifique sua conexão listando os modelos disponíveis. Isso confirma se sua autenticação está funcionando corretamente antes de enviar requisições de geração.
Primeira Requisição
Comece enviando uma requisição simples de conclusão de texto. Este exemplo usa curl para demonstrar a estrutura HTTP bruta. A requisição direciona ao endpoint /v1/chat/completions com o ID do modelo uncensored. A resposta retorna o texto gerado no array choices.
Esta abordagem direta funciona para qualquer linguagem ou ferramenta que suporte formatos HTTP padrão do OpenAI. Você pode testar isso imediatamente após gerar sua chave.
Requisição HTTP Direta
curl https://api.unhingedgrok.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
}'
Integração com SDK Python
Use a biblioteca oficial do OpenAI para Python para integrar nossa API. Instale o pacote via pip. Inicialize o cliente com sua chave e a URL base personalizada. O restante dos métodos do SDK, como chat.completions.create, funciona exatamente como documentado para o OpenAI.
Este método é ideal para serviços backend, scripts de processamento de dados ou fluxos de trabalho automatizados. O SDK lida com serialização JSON e análise de resposta automaticamente.
Exemplo de Código Python
from openai import OpenAI
client = OpenAI(base_url="https://api.unhingedgrok.com/v1", api_key="YOUR_KEY")
resp = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)
Integração com SDK Node.js
Para ambientes JavaScript ou TypeScript, use o pacote npm oficial openai. Configure o cliente com a mesma URL base e chave. O SDK Node.js suporta padrões baseados em callback e promessas.
Esta configuração permite incorporar geração de texto sem censura diretamente em aplicações web, funções serverless ou ferramentas de automação baseadas em Node. O tratamento de erros permanece consistente com o comportamento padrão do SDK do OpenAI.
Exemplo de Código Node.js
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.unhingedgrok.com/v1", apiKey: process.env.API_KEY });
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);
Respostas em Streaming
Ative a geração de tokens em tempo real definindo stream: true. A API retorna um stream de Server-Sent Events (SSE). Cada chunk contém uma resposta parcial. O último chunk inclui estatísticas de uso de tokens.
O streaming reduz a latência percebida para usuários finais. É essencial para interfaces de chat e aplicações interativas. Processe cada chunk incrementalmente para atualizar a interface do usuário imediatamente.
Exemplo de Código de Streaming
stream = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Tell the story in second person."}],
stream=True,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="", flush=True)
Limites, Erros e Contexto
Entenda as restrições operacionais para evitar interrupções no serviço. A janela de contexto suporta 100,000 tokens no total e, se max_tokens não for definido, a resposta pode atingir o final da janela.
Os limites de requisições permitem 300 requisições por minuto por chave. As requisições simultâneas são limitadas a 8. Os corpos das requisições não devem exceder 8 MB. Trate os códigos de erro HTTP padrão: 401 indica uma chave inválida, 402 sinaliza crédito insuficiente e 429 indica limite de requisições excedido. Os erros não consomem crédito.
Especificações técnicas
Todos os limites e recursos reais da API em um só lugar — confira antes de recarregar.
| Item | Valor |
|---|---|
| Formato | compatível com OpenAI: qualquer SDK da OpenAI funciona trocando a base URL e a chave |
| Endpoints | POST /v1/chat/completions · GET /v1/models |
| Base URL | https://api.unhingedgrok.com/v1 |
| Autenticação | Authorization: Bearer YOUR_KEY |
| ID do modelo | uncensored |
| Modo JSON | response_format: {"type": "json_object"} |
| Parâmetros | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| Streaming | sim — server-sent events; o último bloco traz o uso de tokens |
| Saída máxima | até o restante da janela de 100.000 tokens; max_tokens opcional (sem limite separado) |
| Janela de contexto | 100.000 tokens (entrada + saída) |
| Chamada de funções | sim — tools, tool_choice; resposta com tool_calls, inclusive em streaming; resultados como role: tool |
| Limite de taxa | 300 requisições por minuto por chave |
| Tamanho | até 8 MB por requisição |
| Concorrência | 8 requisições ao mesmo tempo por chave |
| Cabeçalhos | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| Bônus | +5% a partir de $50, +10% a partir de $100, +15% a partir de $200 |
| Recarga | USDT (TRC20) ou USDC (Base), qualquer valor inteiro de $20 a $500 |
| Validade | crédito pago não expira, sem assinatura |
| Preço | $0,15 por 1M tokens de entrada · $0,50 por 1M de saída |
| Teste grátis | $0,50 por 7 dias, sem cartão · Chave de teste: 2 requisições paralelas, 60 por minuto; limites totais (8 e 300) após a primeira recarga |
| Cobrança | crédito pré-pago pelo uso real; erros e recusas são grátis |
| Chaves | uma chave ativa por conta; uma nova substitui a anterior |
| Login | Google ou e-mail e senha |
| Conteúdo | conteúdo adulto permitido; conteúdo sexual com menores é recusado |
Erros e o que fazer
Erros chegam em JSON com um type fixo; requisições com falha ou recusadas não são cobradas.
| Código | Tipo | Significado |
|---|---|---|
400 | bad_request | JSON inválido, mensagens vazias, parâmetro errado ou contexto longo demais |
401 | missing_key · invalid_key · key_revoked | chave ausente, errada ou substituída |
402 | no_credit | sem crédito — recarregue e continue na hora |
403 | content_blocked | conteúdo sexual com menores — recusado, sem cobrança |
404 | not_found | endpoint desconhecido |
413 | request_too_large | corpo acima de 8 MB |
429 | rate_limited · concurrency | acima de 300/min ou 8 em paralelo — aguarde e tente de novo |
503 | upstream_busy | modelo ocupado — tente em alguns segundos |
Perguntas e respostas
Esta é a API oficial do Grok?
Não. Somos um serviço independente que hospeda nosso próprio modelo sem censura. Não somos afiliados à X Corp nem à API oficial do Grok. Nossa API é compatível com o formato de cliente do OpenAI, mas executa um modelo diferente.
Como pago pelo uso?
O crédito é recarregado usando criptomoeda (USDT na TRC20 ou USDC na Base). O crédito pré-pago é cobrado com base no uso real de tokens. Erros e recusas são gratuitos. O crédito nunca expira.
Qual é o tamanho da janela de contexto?
O modelo suporta uma janela de contexto de 100,000 tokens para prompt e conclusão combinados. Não há um limite separado de saída. Se max_tokens não for especificado, a resposta pode ir até o final da janela.
Sua chave está a um formulário de distância
Crie uma conta, copie a chave e altere a URL base. Essa é toda a configuração.