Documentação da API: Guia de Início Rápido

URL Base e Autenticação

A API Heretic AI é totalmente compatível com OpenAI. Você interage com ela apontando seu cliente para nossa URL base: https://api.hereticai.cc/v1. A autenticação depende de uma única chave de API por conta, gerada instantaneamente no cadastro via Google ou e-mail. Passe esta chave no Authorization cabeçalho como um token Bearer. O identificador do modelo é simplesmente uncensored. Este modelo único lida com todas as suas solicitações sem complexidade de roteamento. Erros como 401 indicam uma chave inválida, enquanto 402 significa que você precisa de mais crédito cripto pré-pago.

Copycurl https://api.hereticai.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "generate twenty test cases"}]
  }'

Endpoint Chat Completions

Envie solicitações de texto usando o POST /v1/chat/completions endpoint. endpoint. A API espera uma matriz padrão de mensagens contendo seu histórico de conversas ou prompt. Ela retorna o texto gerado no choices array. Esta é uma API puramente utilitária: texto entra, texto sai. Você paga apenas pelos tokens consumidos. O crédito pré-pago nunca expira, e recusas ou erros não consomem tokens. Essa abordagem elimina bloqueios de assinatura e tiers gratuitos imprevisíveis.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.hereticai.cc/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)

Respostas em Streaming (SSE)

Ative o streaming de tokens em tempo real definindo stream: true na sua solicitação. A API retorna Eventos Enviados pelo Servidor (SSE) para cada token gerado. Isso permite que você exiba o output progressivamente, o que é crucial para aplicativos sensíveis à latência. As estatísticas de uso de tokens aparecem no último fragmento do fluxo. Este recurso funciona perfeitamente com SDKs padrão do OpenAI que lidam com SSE automaticamente. Ele fornece feedback imediato sem esperar pela conclusão completa.

Copystream = 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)

Chamada de Função e Ferramentas

A API suporta chamada de funções com o tools e tool_choice parâmetros. Defina os esquemas de suas ferramentas na solicitação, e o modelo retornará chamadas de função estruturadas quando apropriado. Isso permite fluxos de trabalho complexos onde o LLM decide qual ação tomar em seguida. Você pode forçar o uso de ferramentas específicas ou deixar o modelo escolher livremente. Essa capacidade é essencial para construir aplicações agênticas que interagem com sistemas externos ou bancos de dados.

Modo JSON

Garanta saída determinística definindo response_format para {"type": "json_object"}. O modelo restringe sua resposta a JSON válido, o que é vital para análise programática. Isso reduz a necessidade de correções de expressões regulares pós-processamento. Garante que a saída possa ser consumida diretamente pelo seu código. Isso é particularmente útil para extração de dados estruturados ou tarefas de geração de configuração.

Parâmetros e Limites

Controle a geração com parâmetros padrão como temperature, top_p, e seed. A janela de contexto é de 100.000 tokens para prompt mais conclusão. A saída máxima é de 16.000 tokens por solicitação, ou 2.048 se max_tokens está indefinido. Os limites de taxa são de 300 solicitações por minuto e 8 solicitações simultâneas por chave. O corpo da solicitação deve permanecer abaixo de 8 MB. Esses limites garantem um uso estável de alto volume para desenvolvedores.

Node.js

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.hereticai.cc/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);