Documentação para Desenvolvedores

URL Base e Autenticação

Usar https://api.caiapi.cc/v1 como sua URL base. Autentique passando sua chave de API exclusiva no Authorization cabeçalho. Esta abordagem padrão permite que você substitua por qualquer SDK compatível com OpenAI sem reescrever sua lógica de conexão.

Copycurl https://api.caiapi.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Get user_id 99 for account settings."}]
  }'

Sua chave concede acesso ao modelo sem censura. Mantenha-a segura, pois ela rastreia o uso de tokens e a faturamento diretamente.

Primeira solicitação com Python

Inicialize o cliente com sua chave e o URL base correto. Envie um prompt simples para verificar a conectividade e a qualidade da resposta.

Copyfrom openai import OpenAI

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

Esperar uma resposta de texto direta. O modelo ignora os filtros de conteúdo padrão, tornando-o ideal para roleplay ou escrita criativa.

Integração do SDK Node

Instale o SDK oficial e configure-o para apontar para nosso endpoint. Isso garante compatibilidade com projetos existentes em TypeScript ou JavaScript.

Copyimport OpenAI from "openai";

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

Lide com o objeto de resposta para extrair o texto gerado. A estrutura corresponde às saídas padrão da OpenAI.

Respostas em Streaming

Ative o streaming definindo stream: true. Receba tokens conforme são gerados, o que reduz a latência percebida para saídas longas.

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)

Os detalhes de uso de tokens aparecem no último chunk. Este método é ideal para interfaces de chat em tempo real.

Chamada de Função e Modo JSON

Defina ferramentas na solicitação para obter saídas estruturadas. Use response_format: {"type": "json_object"} para impor formatação JSON estrita.

Este recurso permite que sua aplicação analise as saídas do modelo programaticamente. Funciona de forma confiável com o modelo uncensored para tarefas criativas e lógicas.

Limites de Taxa e Erros

Limite: 300 requisições por minuto. Simultâneas: 8 requisições por chave. Erro 401 significa chave inválida. Erro 402 significa sem crédito. Erro 429 significa limite de taxa excedido. Janela de contexto: 100.000 tokens. Saída máxima: 16.000 tokens.

Os erros não consomem crédito. Ajuste sua lógica de nova tentativa de acordo.