Início Rápido de Integração da API Character

Instale o SDK

Come instalando a biblioteca de cliente oficial para a sua linguagem. Isso garante compatibilidade com o endpoint compatível com OpenAI que fornecemos. A biblioteca cuida da serialização e da lógica de novas tentativas para você.

Para Python, use pip. Para Node.js, use npm. Esta etapa leva segundos e configura o ambiente para as amostras de código que se seguem.

Configure sua URL Base

Aponte o cliente SDK para o nosso endpoint para acessar o modelo sem censura. O URL base é HTTPS://api.apicharacter.com/v1. Isso substitui o URL padrão da OpenAI na sua configuração.

Sem essa alteração, as solicitações falharão ou atingirão o serviço errado. Você precisa definir isso apenas uma vez ao inicializar sua instância de cliente.

Definir sua chave de API

Inserir sua chave na variável de ambiente ou na configuração do cliente. A autenticação é obrigatória para cada solicitação para rastrear o uso do seu crédito pré-pago. Sua chave concede acesso ao endpoint de LLM sem censura.

Mantenha este valor seguro. Ele atua como sua única credencial para a conta. Nenhum número de telefone ou verificação adicional é necessário para acesso básico.

Faça Sua Primeira Requisição

Envie uma conclusão de chat simples para verificar a conectividade. O ID do modelo é "uncensored". Isso confirma que sua autenticação e URL base estão corretos antes de construir seu aplicativo.

Veja o exemplo abaixo para uma solicitação cURL padrão.

Copycurl https://api.apicharacter.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "set my name to Alex"}]
  }'

Trate Respostas em Streaming

Ative o streaming para menor latência em suas interfaces de chat. Defina o parâmetro stream como true em sua solicitação. O SDK retornará tokens conforme são gerados.

Isso é crítico para experiências de usuário responsivas. Você gerencia os fragmentos parciais conforme chegam por meio de Server-Sent Events.

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)

Limites, Erros e Contexto

Entenda suas restrições para evitar interrupções no serviço. Você tem uma janela de contexto de 100.000 tokens. A saída máxima é de 16.000 tokens, a menos que você especifique o contrário.

O limite de taxa é de 300 solicitações por minuto. Um erro 401 significa chave inválida. Um erro 402 significa crédito zero. Um erro 429 significa que você atingiu o limite de taxa. Tenha isso em mente para dimensionamento em produção.

Python

Copyfrom openai import OpenAI

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