Documentación de KiApi: integración en 5 minutos

Primeros pasos: URL base y autenticación

La KiApi es completamente compatible con la API de OpenAI. Puedes utilizar el ecosistema existente de SDKs y clientes ajustando la base_url. La URL base para todas las peticiones es https://api.kiapis.com/v1. La autenticación se realiza exclusivamente mediante una clave de API que obtendrás en tu página de panel después del registro. Esta clave debe enviarse en el encabezado HTTP Authorization: Bearer <IHR_API_SCHLÜSSEL>. Puedes generar una nueva clave en cualquier momento, lo que invalidará la anterior.

A diferencia de otros servicios, no ofrecemos endpoints complejos para embeddings o fine-tuning. Nuestro enfoque es la generación de texto pura. KiApi es tu conexión directa a un modelo optimizado para respuestas sin censura. Asegúrate de configurar tu entorno correctamente antes de enviar tu primera petición.

POST /v1/chat/completions: generación de texto

El núcleo de la API es el endpoint POST /v1/chat/completions. Aquí envías una lista de mensajes (sistema, usuario, asistente) y recibes una respuesta textual. El parámetro de ID del modelo debe establecerse en uncensored. La respuesta es síncrona e incluye inmediatamente el fragmento de texto generado junto con metadatos de uso de tokens.

La estructura de la petición sigue el formato estándar. Puedes definir roles para estructurar claramente el contexto. El sistema procesa la entrada y genera una respuesta basada en el comportamiento aprendido del modelo. Este es el método principal para casi todas las aplicaciones de texto, desde chatbots hasta análisis de texto.

Kopierencurl https://api.kiapis.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

La respuesta contiene un objeto JSON con el contenido generado. Asegúrate de extraer el área content de la respuesta para usarla en tu aplicación. No se devuelven metadatos adicionales como costo por petición en la respuesta estándar; esa información está en el panel.

Streaming con Server-Sent Events (SSE)

Para aplicaciones que requieren salida inmediata, KiApi admite streaming mediante Server-Sent Events (SSE). Actívalo estableciendo "stream": true en el cuerpo de la petición. En lugar de esperar una respuesta completa, recibirás un flujo de parches JSON que contienen gradualmente el texto generado.

Esto es especialmente útil para interfaces de chat, donde la retroalimentación inmediata mejora la experiencia del usuario. La API de streaming de KiApi te permite reducir la latencia y simular una conversación en tiempo real. El cliente debe analizar el flujo y unir los fragmentos hasta que se señale el final del streaming.

Kopierenstream = 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)

Durante el streaming, las estadísticas de uso de tokens a menudo se devuelven al final del flujo en el último evento. Esto permite un cobro preciso basado en la longitud real de la generación. Asegúrate de que tu código cliente maneje el final del flujo para liberar recursos correctamente.

Llamadas a herramientas y funciones

El modelo admite llamadas a herramientas, también conocido como llamadas a funciones. Esto permite que el LLM devuelva datos JSON estructurados que representan funciones o acciones específicas en tu aplicación. Defines las herramientas disponibles en el cuerpo de la petición, y el modelo decide cuándo llamar a una herramienta según la entrada del usuario.

La estructura de las definiciones de herramientas sigue el estándar de OpenAI. Puedes especificar varias herramientas, y el modelo elegirá la más adecuada. La respuesta contiene una lista de llamadas a herramientas que luego puedes ejecutar en tu lógica de backend. Esto amplía las capacidades de KiApi más allá de la pura generación de texto.

Kopierenfrom openai import OpenAI

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

Usa llamadas a herramientas para automatizar flujos de trabajo complejos. El modelo proporciona los parámetros de la herramienta directamente en formato JSON. No necesitas usar parsers externos para la respuesta, ya que la estructura proviene directamente del modelo. Esto hace que la integración en sistemas existentes sea mucho más fácil y confiable.

GET /v1/models: modelos disponibles

El endpoint GET /v1/models lista los modelos disponibles a los que se puede acceder a través de la API. Esto es útil para verificar dinámicamente qué modelos están disponibles o para confirmar el ID del modelo. Por lo general, recibirás una lista con el modelo uncensored.

La respuesta contiene metadatos del modelo, como ID, propietario y fecha de creación. A diferencia de algunas otras APIs, la respuesta estándar no incluye directamente la longitud máxima de la ventana de contexto ni precios específicos. Esta información debe obtenerse de la documentación o el panel. Sin embargo, este endpoint es indispensable para la configuración automática de clientes.

Kopierenimport OpenAI from "openai";

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

Usa este endpoint para adaptar tu aplicación a cambios futuros. Si se agregan nuevos modelos, aparecerán automáticamente en esta lista. El modelo actual uncensored es el único modelo disponible y se caracteriza por ser un modelo de lenguaje grande optimizado para contenido sin censura.

Límites de peticiones y códigos de error

Para garantizar la estabilidad del servicio, existen ciertos límites. Se permiten 300 peticiones por minuto por clave de API. El cuerpo máximo de la petición es de 8 MB. Si superas estos límites, recibirás el código de estado HTTP 429 Too Many Requests. Planifica tu aplicación para implementar reintentos con retroceso exponencial.

Otros códigos de error comunes son 401 Unauthorized si la clave de API no es válida, y 402 Payment Required si se agota tu crédito. KiApi usa un modelo de crédito prepago, por lo que las peticiones sin crédito se rechazan inmediatamente. Asegúrate de revisar regularmente el saldo de tu cuenta.

La ventana de contexto es de 100.000 tokens para entrada y salida combinadas. Si superas este límite, se devuelve un mensaje de error. KiApi es una solución confiable para desarrolladores que valoran reglas claras y límites transparentes.