Início rápido: API de Completions de Chat

Pré-requisitos e URL base

Nossa API é totalmente compatível com a interface padrão de conclusões de chat da OpenAI. Você só precisa de uma URL base e uma chave de API para começar a enviar solicitações. A URL base é HTTPS://api.howmuchisanapikey.com/v1. Este único endpoint lida com toda a geração de texto sem exigir que você gerencie vários URLs de serviço ou configurações de proxy.

A autenticação é direta. Você deve incluir um cabeçalho Authorization com o esquema Bearer seguido pela sua chave exclusiva. Cada solicitação para o endpoint de conclusões de chat requer este cabeçalho para validar sua conta e rastrear o uso de tokens contra seu saldo de crédito pré-pago.

Autenticação e cabeçalhos

Inclua o cabeçalho Authorization em todas as solicitações para verificar sua identidade. O formato do cabeçalho é Authorization: Bearer YOUR_API_KEY. Se a chave for inválida ou expirada, a API retorna um erro 401 imediatamente. Isso garante que apenas contas autorizadas possam consumir seu crédito pré-pago.

Você não precisa passar cabeçalhos adicionais para geração básica de texto. No entanto, se você usar recursos específicos como modo JSON ou chamada de funções, deve definir o cabeçalho Content-Type para application/json. Isso diz ao servidor como analisar o corpo da solicitação corretamente.

Enviando sua primeira conclusão de chat

Envie uma solicitação POST para /v1/chat/completions com seu histórico de mensagens e identificador do modelo. O id do modelo é "uncensored". Este modelo é ajustado para responder sem recusas para conteúdo adulto lícito, ficção ou tópicos controversos. Ele não filtra com base em normas políticas ou sociais padrão.

Aqui está um exemplo básico de curl para você começar:

Copycurl https://api.howmuchisanapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate a simple hello world function in python"}]
  }'

A resposta conterá o texto gerado no array choices. Você pode analisar isso diretamente na lógica da sua aplicação. Cada solicitação consome tokens de entrada para seu prompt e tokens de saída para a resposta do modelo.

Respostas em streaming e uso de tokens

Use Server-Sent Events (SSE) para receber tokens conforme são gerados. Isso reduz a latência percebida para saídas longas. Defina o parâmetro stream como true no corpo da sua solicitação. O servidor enviará vários chunks, cada um contendo um delta parcial da resposta.

O último chunk inclui os dados de uso. Este objeto contém o total de tokens de entrada e saída consumidos pela solicitação. Você pode usar esses dados para atualizar seu saldo de crédito local ou monitorar seus gastos em tempo real. O streaming é ideal para interfaces de chat onde os usuários esperam feedback instantâneo.

Chamada de função e modo JSON

A API suporta saída estruturada via modo JSON e chamada de funções. Defina response_format como {"type": "json_object"} para forçar o modelo a retornar JSON válido. Isso é útil para extrair dados ou gerar configurações estruturadas sem erros de análise.

Para chamada de funções, forneça um array de tools na sua solicitação. O modelo responderá com tool_calls se determinar que uma função é necessária. Você pode então executar a função e enviar o resultado de volta ao modelo. Isso permite fluxos de trabalho complexos em múltiplos passos sem lógica de parsing externa.

Lidando com limites e erros

Você está limitado a 300 solicitações por minuto por chave e 8 solicitações simultâneas. Se você exceder esses limites, receberá um erro 429 Too Many Requests. O corpo da resposta incluirá detalhes de retry-after. Ajuste o throttling no lado do cliente para evitar retries desnecessários.

Se o seu crédito pré-pago se esgotar, a API retornará um erro 402 Payment Required. Você pode fazer recargas via criptomoeda a qualquer momento. Erros e recusas são gratuitos, então você paga apenas pela geração bem-sucedida de tokens. A janela de contexto é de 100,000 tokens para prompt e conclusão combinados.

Python

Copyfrom openai import OpenAI

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

Node.js

Copyimport OpenAI from "openai";

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

Streaming

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)