URL Base e Autenticação
A API Chatterbot fica em https://api.chatterbotapi.com/v1. Você autentica com um token Bearer no Authorization cabeçalho. Sua chave aparece imediatamente após o cadastro via Google ou e-mail.
- URL Base:
https://api.chatterbotapi.com/v1 - Cabeçalho:
Authorization: Bearer YOUR_API_KEY
Uma chave por conta substitui a antiga instantaneamente. Mantenha-a segura.
Primeira solicitação
Envie uma requisição POST para /v1/chat/completions com o modelo uncensored. A API retorna texto gerado sem recusas padrão para conteúdo adulto legal.
Aqui está um exemplo mínimo de cURL:
curl https://api.chatterbotapi.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "What is the capital city of France"}]
}'Verifique se a resposta inclui o texto gerado em choices[0].message.content.
Integração do SDK Python
Use a biblioteca Python oficial da OpenAI. Aponte-a para a nossa URL base e injete sua chave. O cliente lida com a serialização JSON automaticamente.
from openai import OpenAI
client = OpenAI(base_url="https://api.chatterbotapi.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)Esta abordagem funciona tanto para chamadas com streaming quanto sem streaming. O ID do modelo permanece uncensored.
Configuração do SDK Node.js
Inicialize o pacote npm OpenAI com o URL base personalizado. Isso garante compatibilidade com clientes OpenAI existentes.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.chatterbotapi.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);Configure a variável de ambiente ou passe a chave diretamente. A API se comporta como qualquer endpoint padrão de chat-completions.
Respostas em Streaming
Ative o streaming definindo stream: true. A API envia Eventos Enviados pelo Servidor. Os dados de uso de tokens aparecem apenas no último fragmento.
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)Processe cada chunk conforme chega. Isso reduz a latência percebida para saídas longas de até 16.000 tokens.
Limites e Erros
Esperar um erro 401 se a chave for inválida. Um erro 402 significa que seu crédito pré-pago está esgotado. Erros e recusas não consomem tokens. Você está limitado a 300 solicitações por minuto. A janela de contexto contém 100.000 tokens no total. Os corpos das solicitações devem permanecer abaixo de 8 MB.