Inicio Rápido de Integración de API de Character

Instala el SDK

Comienza instalando la biblioteca de cliente oficial para tu lenguaje. Esto garantiza la compatibilidad con el endpoint compatible con OpenAI que proporcionamos. La biblioteca se encarga de la serialización y la lógica de reintento por ti.

Para Python, usa pip. Para Node.js, usa npm. Este paso tarda segundos y configura el entorno para las muestras de código que siguen.

Configura tu URL base

Apunta tu cliente SDK a nuestro punto de conexión para acceder al modelo sin censura. La URL base es HTTPS://api.apicharacter.com/v1. Esto reemplaza la URL predeterminada de OpenAI en tu configuración.

Sin este cambio, las solicitudes fallarán o llegarán al servicio incorrecto. Solo necesitas configurar esto una vez al inicializar tu instancia de cliente.

Establecer tu clave API

Inyecta tu clave en la variable de entorno o en la configuración del cliente. La autenticación es obligatoria para cada solicitud para rastrear el uso de tu crédito prepagado. Tu clave otorga acceso al endpoint de LLM sin censura.

Mantén este valor seguro. Actúa como tu única credencial para la cuenta. No se requiere número de teléfono ni verificación adicional para el acceso básico.

Hacer su primera solicitud

Envía una finalización de chat simple para verificar la conectividad. El ID del modelo es "uncensored". Esto confirma que tu autenticación y la URL base son correctas antes de construir tu aplicación.

Ve el ejemplo a continuación para una solicitud cURL estándar.

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"}]
  }'

Gestionar respuestas de transmisión

Activa la transmisión para menor latencia en tus interfaces de chat. Establece el parámetro stream en true en tu solicitud. El SDK generará tokens a medida que se generen.

Esto es crítico para experiencias de usuario responsivas. Manejas los fragmentos parciales a medida que llegan mediante 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)

Límites, Errores y Contexto

Comprende tus restricciones para evitar interrupciones del servicio. Obtienes una ventana de contexto de 100.000 tokens. La salida máxima es de 16.000 tokens a menos que especifiques lo contrario.

El límite de velocidad es de 300 solicitudes por minuto. Un error 401 significa una clave inválida. Un 402 significa saldo cero. Un 429 significa que has alcanzado el límite de velocidad. Ten esto en cuenta para la escalabilidad en producción.

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);