URL base e autenticação
Nossa API segue o padrão OpenAI Chat Completions. Para interagir com o serviço, direcione seu cliente para https://api.grokapikey.com/v1 e inclua sua chave de API exclusiva no cabeçalho Authorization. Você pode gerar essa chave imediatamente após entrar com apenas um e-mail e senha. A chave é exibida uma única vez na criação, então guarde-a com segurança. Se você a perder, poderá gerar uma nova chave no seu painel, o que revoga instantaneamente a anterior. Não é necessário vincular um cartão de crédito para a conta de teste.
Sua primeira requisição
Comece enviando um prompt de texto simples para verificar a conectividade. Use o endpoint padrão chat/completions com o identificador do modelo uncensored. O exemplo a seguir demonstra um comando curl básico para testar a conexão. Isso confirma que sua autenticação está correta e que o serviço está respondendo. Você pode então adaptar essa estrutura para a lógica específica do seu aplicativo.
Substitua YOUR_API_KEY pela sua chave real antes de executar este comando.
curl https://api.grokapikey.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
Se você está construindo um aplicativo Python, use a biblioteca oficial openai. Configure o cliente para usar nossa URL base e sua chave de API. Isso permite que você aproveite os idiomatismos familiares do Python ao acessar o modelo sem censura. O cliente lida com a serialização e o streaming automaticamente. Certifique-se de que seu ambiente tenha a versão mais recente da biblioteca instalada para melhor compatibilidade com nossos endpoints.
from openai import OpenAI
client = OpenAI(base_url="https://api.grokapikey.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 projetos JavaScript ou TypeScript, o SDK OpenAI para Node.js é pronto para usar. Defina as propriedades apiKey e baseURL no seu objeto de configuração. Isso garante que todas as requisições subsequentes sejam roteadas pela nossa infraestrutura. Você pode usar padrões assíncronos padrão (async/await) para lidar com as respostas. Esta abordagem é ideal para aplicações do lado do servidor ou funções de borda que exigem acesso direto à API sem fazer proxy por meio da OpenAI.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.grokapikey.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
Para aplicações que se beneficiam da geração de tokens em tempo real, ative o streaming definindo stream: true no corpo da sua requisição. A API retorna um fluxo de Eventos Enviados pelo Servidor (SSE) com respostas parciais. Isso reduz a latência percebida para os usuários e permite a exibição imediata do texto gerado. Cada fragmento contém um delta da resposta. Processe esses eventos no seu código do cliente para atualizar a interface do usuário progressivamente. O streaming consome tokens normalmente e não afeta o preço.
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
Cada chave de API está limitada a 300 requisições por minuto e um tamanho máximo de corpo de requisição de 8 MB. Se você exceder o limite de requisições, a API retornará o código de status 429; aguarde alguns segundos e tente novamente. Um erro 401 indica uma chave inválida ou revogada, enquanto um erro 402 significa que seu crédito pré-pago está esgotado. O modelo suporta uma janela de contexto de 100.000 tokens para entrada e saída combinadas. Certifique-se de que seus prompts se encaixem nesse limite para evitar truncamento. Os filtros de conteúdo permanecem mínimos, exceto por um bloqueio rígido de conteúdo sexual envolvendo menores.
