ES ▾
Obtener clave de API

Clave de API de Character AI: Cómo obtener y usar una

Si buscaste una clave de API de character ai, lo primero que debes saber es que este sitio no es Character.ai y no emite sus claves. Te proporciona una clave para una API de texto independiente y compatible con OpenAI que funciona como un backend listo para usar para aplicaciones de chat de personajes.

Una clave brillante sobre paneles de chat conectados a un cubo de servidor, ilustrando el acceso a la clave de API

Puntos clave

  1. Obtienes una clave después de registrarte con Google o correo electrónico y contraseña, y luego abriendo la página de la clave de API.
  2. Los nuevos usuarios pueden reclamar $0,50 de crédito de prueba con un solo clic, sin necesidad de tarjeta, válido por 7 días.
  3. Usa la URL base https://api.characteraiapi.com/v1 y el ID de modelo uncensored con cualquier SDK de OpenAI.
  4. Mantén la clave en un servidor o en una variable de entorno, nunca en código de front-end público.

Lo que realmente estás obteniendo

Character.ai es un producto de chat para consumidores. Quienes buscan una clave de API de character ai generalmente quieren una de dos cosas: una forma de llamar a un chatbot de personaje desde su propio código, o un backend para una app de personaje que no esté limitada por las reglas de un producto alojado. Este sitio cubre la segunda necesidad. Te registras, recibes una clave y envías peticiones a un endpoint compatible con OpenAI. Nada aquí se conecta a Character.ai ni reutiliza sus personajes.

El servicio es una API de texto alojada frente a un único modelo de pesos abiertos, gestionado por un proveedor independiente y ajustado para responder sin rechazos de contenido para uso adulto lícito. No es la API oficial de ningún proveedor de modelos ni un enrutador entre proveedores. El ID del modelo es uncensored, y la URL base es https://api.characteraiapi.com/v1. Existen dos métodos: POST /v1/chat/completions y GET /v1/models.

Como la interfaz coincide con la de OpenAI, el trabajo de construir un personaje está de tu lado. Escribes la personalidad como un mensaje del sistema, mantienes el historial de la conversación y lo envías con cada petición. Eso te da control sobre la voz, la memoria y el ritmo que un producto cerrado rara vez expone. El límite estricto es el mismo para todos los usuarios: sin contenido sexual que involucre a menores de edad, siempre.

Obtén tu clave en cinco pasos

Todo el proceso toma unos minutos. No necesitas una tarjeta para empezar.

  1. Regístrate. Usa Google, o regístrate con un correo electrónico y contraseña.
  2. Abre la página de claves. Ve a la página de la clave de API, donde se muestra la clave de tu cuenta.
  3. Reclama la prueba. Un clic en esa página añade $0,50 de crédito de prueba. Está limitado a uno por persona y es válido durante 7 días.
  4. Copia la clave. Guárdala en un gestor de contraseñas o en un archivo de secretos de inmediato.
  5. Envía una petición de prueba. Usa el comando curl a continuación antes de tocar cualquier código de aplicación.

Trata la clave como una contraseña. Cualquiera que la tenga puede gastar tu saldo. Si crees que se filtró, deja de usarla de inmediato, elimínala de todas las aplicaciones y verifica tu saldo para ver gastos inesperados.

Prueba la clave con curl

Establece la clave como una variable de entorno para que nunca quede en tu historial de shell como texto plano dentro de un script. Luego lista los modelos. Esto confirma que la clave funciona y que alcanzas el host correcto.

export API_KEY="paste-your-key-here"

curl https://api.characteraiapi.com/v1/models \
  -H "Authorization: Bearer $API_KEY"

Deberías obtener una lista JSON que incluya uncensored. Ahora envía una primera petición de chat con una personalidad pequeña. El mensaje del sistema establece el personaje, el mensaje del usuario inicia la escena.

curl https://api.characteraiapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [
      {"role": "system", "content": "You are Mara, a dry-witted ship engineer in a space opera. Stay in character."},
      {"role": "user", "content": "The reactor is humming wrong again. What do you do?"}
    ],
    "temperature": 0.9
  }'

La respuesta sigue la forma estándar de finalizaciones de chat. El texto de la respuesta está en choices[0].message.content. Los encabezados de respuesta también contienen X-Request-Id, X-Balance-USD y los encabezados de límite de peticiones, lo cual es útil cuando quieres mostrar un saldo restante en tu propia interfaz.

Usa la clave desde Python o Node

Cualquier SDK de OpenAI funciona una vez que cambias dos valores: la URL base y la clave. Aquí está la versión de Python con el paquete oficial openai.

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.characteraiapi.com/v1",
    api_key=os.environ["API_KEY"],
)

reply = client.chat.completions.create(
    model="uncensored",
    messages=[
        {"role": "system", "content": "You are Mara, a ship engineer. Stay in character."},
        {"role": "user", "content": "Status report?"},
    ],
)
print(reply.choices[0].message.content)

Y la misma llamada en Node:

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.characteraiapi.com/v1",
  apiKey: process.env.API_KEY,
});

const reply = await client.chat.completions.create({
  model: "uncensored",
  messages: [
    { role: "system", content: "You are Mara, a ship engineer. Stay in character." },
    { role: "user", content: "Status report?" },
  ],
});
console.log(reply.choices[0].message.content);

Muchas interfaces de chat tienen un campo para un endpoint personalizado compatible con OpenAI. En esas herramientas, pegas la URL base, pegas la clave y escribes uncensored como el nombre del modelo. No necesita cambiar nada más. La página de documentación lista los parámetros admitidos, incluyendo streaming, llamadas a funciones y modo JSON.

Problemas comunes con las claves y soluciones rápidas

La mayoría de los fallos de primer uso provienen de un puñado de pequeños errores. Revísalos en este orden antes de sospechar algo más grande.

  • Espacios en blanco adicionales o comillas en la clave. Una nueva línea final copiada de un archivo es suficiente para que falle la autenticación. Imprime la longitud de la variable y compárala con lo que copiaste.
  • URL base incorrecta. La URL base termina en /v1, y el SDK añade /chat/completions por sí mismo. Si también añades /chat/completions a la URL base, la ruta se duplica y la petición falla.
  • Nombre de modelo incorrecto. El ID del modelo es uncensored. Los nombres tomados de otros servicios no coincidirán. Llama a GET /v1/models para ver qué informa el servidor.
  • Falta un encabezado. Las llamadas HTTP crudas necesitan Authorization: Bearer seguido de un espacio y la clave, más Content-Type: application/json en las peticiones POST.
  • Saldo vacío. El encabezado de respuesta X-Balance-USD muestra lo que queda. Cuando se gasta el crédito de prueba o han pasado 7 días, recarga o las peticiones dejarán de tener éxito.
  • Límites de peticiones. Una clave de prueba permite 2 peticiones simultáneas y 60 por minuto. Dos streams abiertos ya ocupan ambas ranuras.

Una clave incorrecta generalmente produce un error de autenticación en lugar de una respuesta del modelo. Un límite produce HTTP 429 con el código rate_limited o concurrency. Leer el cuerpo del error, no solo el código de estado, ahorra tiempo porque el código te dice qué límite alcanzaste. Cada respuesta lleva un X-Request-Id; guárdalo en tus registros para que puedas hacer coincidir una llamada fallida con una petición específica más tarde.

Límites de la prueba y qué compra la prueba

Una clave de prueba tiene límites más bajos que una completa: 2 peticiones simultáneas y 60 peticiones por minuto. Una clave completa permite 8 peticiones simultáneas y 300 peticiones por minuto. Para probar una sola personalidad es suficiente. Si ejecutas varios chats a la vez desde un script de prueba, verás HTTP 429 con el código de error concurrency o rate_limited. Una petición en streaming mantiene su ranura de concurrencia hasta que termina el stream, por lo que dos streams abiertos en una clave de prueba la llenan.

¿Hasta dónde llega $0,50? Los precios son $0,15 por 1M de tokens de entrada y $0,50 por 1M de tokens de salida. Toma un turno de chat típico con 1.500 tokens de historial y personalidad entrando y 300 tokens saliendo:

  • Entrada: 1.500 tokens x $0,15 / 1.000.000 = $0,000225
  • Salida: 300 tokens x $0,50 / 1.000.000 = $0,00015
  • Un turno: $0,000375
  • $0,50 / $0,000375 son aproximadamente 1.333 turnos

Eso es suficiente para probar varios personajes adecuadamente. Las peticiones fallidas o rechazadas no se cobran, por lo que una petición que da error no consume tu crédito. La prueba expira después de 7 días; el crédito que compres después no caduca.

Configuraciones para que una personalidad se sienta adecuada

Una clave te da la conexión; la calidad de un personaje proviene del prompt y de la configuración de muestreo. Algunos hábitos ayudan más que los trucos ingeniosos.

Escribe el mensaje del sistema como una ficha de personaje corta en oraciones simples: quién es el personaje, cómo habla, qué quiere y qué longitud deben tener sus respuestas. Da una o dos líneas de diálogo de ejemplo si la voz es importante. Los modelos siguen mejor los ejemplos concretos que los adjetivos, por lo que una línea como "Mara responde en oraciones cortas y secas y bromea cuando está nerviosa" funciona mejor que "Mara es ingeniosa y encantadora".

Usa temperature para definir la vivacidad. Los valores cercanos a 0.9 dan una redacción más variada, mientras que los valores cercanos a 0.5 mantienen al personaje más estable. Añade una secuencia stop si tu aplicación usa una etiqueta de hablante como "Usuario:" y quieres evitar que el modelo escriba la otra parte de la conversación. Las penalizaciones de frecuencia y presencia pueden reducir las frases repetidas en chats largos, pero súbelas con cuidado, ya que valores altos pueden hacer que el diálogo sea extraño.

Recuerda que el modelo solo sabe lo que está en la petición. Si el personaje debe recordar el nombre del jugador hace 200 mensajes, mantén ese mensaje en la ventana de contexto o almacena los datos clave en el mensaje del sistema. Por eso una lista de memoria que actualices tú mismo suele ser mejor que enviar un historial enorme.

Recargar cuando se agota la prueba

No hay suscripción. Pagas por adelantado y gastas por token. Las recargas aceptan cualquier cantidad entera desde $20 hasta $500, y las cantidades mayores tienen un bono: +5% desde $50, +10% desde $100 y +15% desde $200. Así, $50 se convierte en $52,50 de crédito, $100 en $110 y $200 en $230. Puedes pagar con cripto (USDT en TRC20, USDC en Base).

La página de precios tiene la tabla completa. Para planificar, un turno de 1.500 tokens de entrada y 300 de salida cuesta $0,000375, así que $20 cubren aproximadamente 53.000 turnos de este tipo. El roleplay de larga duración cuesta más por turno porque el historial crece, así que limita cuánto de eso reenvías. La ventana de contexto es de 100.000 tokens, prompt más completion, pero rara vez querrás llenarla.

Mantener la clave segura en una aplicación real

El error más común en un proyecto de chat es llamar a la API directamente desde el código del navegador. Todo lo que se envía al navegador puede ser leído por cada visitante, incluida la clave. Pon un servidor pequeño entre tu interfaz y la API. El navegador habla con tu ruta, tu ruta añade el encabezado Authorization: Bearer y reenvía la petición.

  • Almacena la clave en una variable de entorno o en un gestor de secretos, no en el repositorio.
  • Añade una entrada .env a .gitignore antes de tu primer commit.
  • Usa una clave por entorno para que una fuga en desarrollo no afecte a producción.
  • Vigila el encabezado X-Balance-USD para detectar bucles descontrolados pronto.
  • Reintenta en HTTP 429 con una espera corta. Una respuesta de sobrecarga temporal incluye Retry-After: 5.

Los prompts enviados a la API no se usan para entrenamiento. Aun así, evita enviar datos que no quisieras almacenar en un log en tu propio lado. Si quieres una mirada más profunda a lo que hace y no hace una API así, el artículo de mitos y hechos cubre los malentendidos comunes.

Preguntas y respuestas

¿Esto me da una clave de API de Character.ai?

No. Este es un servicio separado e independiente. Obtienes una clave para un endpoint compatible con OpenAI con el ID de modelo uncensored, que puedes usar como backend para tus propias aplicaciones de personajes.

¿Necesito una tarjeta para obtener una clave?

No. Te registras con Google o con correo electrónico y contraseña, luego reclamas $0,50 de crédito de prueba con un solo clic en la página de la clave de API. La prueba es válida por 7 días.

¿Puedo usar la clave en SillyTavern u otras interfaces de chat?

Las herramientas que aceptan un endpoint compatible con OpenAI pueden usarlo. Ingresa la URL base, tu clave y el nombre del modelo uncensored.

¿Qué sucede cuando alcanzo un límite de peticiones?

La API devuelve HTTP 429 con el código rate_limited o concurrency. Espera un momento y reintenta. Una clave de prueba permite 2 peticiones simultáneas y 60 por minuto.

¿Caduca el crédito?

El crédito comprado no caduca. Solo el crédito de prueba de $0,50 tiene una ventana de 7 días.

Tu clave está a un formulario de distancia

Crea una cuenta, copia la clave, cambia la URL base. Esa es toda la configuración.

Obtener clave de API