Documentación de la API Kimicode

URL Base y Autenticación

Conéctate a la API utilizando la URL base proporcionada y una clave de token prepagada. Te autenticas pasando tu clave de API en el encabezado de la solicitud, asegurando que solo tu cuenta acceda a tus créditos. Regístrate con Google o correo electrónico para recibir tu clave inmediatamente sin verificación por teléfono.

Copycurl https://api.kimicodeapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "What is the current rate limit for free tier users?"}]
  }'

Tus solicitudes apuntan al endpoint estándar compatible con OpenAI. Este diseño te permite cambiar a nuestro servicio sin reescribir el código de tu cliente existente, siempre que actualices la URL base y las credenciales.

Endpoint Chat Completions

Envía mensajes al modelo usando el POST /v1/chat/completions endpoint. Debes especificar el ID del modelo como uncensored acceder al modelo de lenguaje grande optimizado que se ejecuta en nuestros servidores. El sistema acepta roles de mensaje estándar como usuario o asistente para conversaciones de múltiples turnos.

Copyfrom openai import OpenAI

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

Este extremo maneja entrada de texto y devuelve texto generado. No admite embeddings, imágenes ni audio. Concéntrate en la estructura de tu prompt para obtener los mejores resultados del modelo sin censura.

Respuestas en streaming (SSE)

Habilita la entrega de tokens en tiempo real estableciendo el parámetro stream en true en tu solicitud. La API devuelve fragmentos de Eventos Enviados por Servidor (SSE), permitiendo que tu aplicación muestre el texto a medida que se genera. El último fragmento contiene las estadísticas completas de uso de tokens para facturación.

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)

El streaming reduce la latencia percibida para los usuarios finales. Puedes procesar cada token a medida que llega, lo cual es ideal para interfaces de chat. Recuerda que el streaming no cambia el comportamiento subyacente del modelo ni el precio de los tokens.

Llamada de Función y Herramientas

Define las herramientas en tu solicitud para permitir que el modelo devuelva llamadas a funciones estructuradas. La API admite parámetros tool_choice, lo que te permite forzar al modelo a usar una herramienta específica o permitirle decidir de forma autónoma. Esta función funciona con los formatos estándar de herramientas de OpenAI, lo que facilita la integración.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.kimicodeapi.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 la llamada a funciones para extraer datos o desencadenar acciones en tus aplicaciones. El modelo interpreta las definiciones de las herramientas y devuelve objetos JSON que contienen los argumentos necesarios. Esta capacidad amplía la API más allá de la simple generación de texto.

Modo JSON y parámetros

Aplicar salida JSON estricta configurando response_format para {"type": "json_object"}. Esto garantiza que el modelo devuelva JSON, lo cual es crucial para el análisis programático. También puedes ajustar parámetros como la temperatura, top_p y secuencias de parada para controlar la creatividad y la longitud de la salida.

El modelo admite una ventana de contexto de 100,000 tokens. Esto te permite pasar grandes cantidades de contexto en una sola solicitud. La salida máxima es de 16,000 tokens por solicitud, o 2,048 si no especificas max_tokens.

Límites, Errores y Contexto

Monitora tus límites de solicitudes para evitar interrupciones del servicio. La API permite 300 solicitudes por minuto por clave y hasta 8 solicitudes concurrentes. El cuerpo de tu solicitud debe mantenerse por debajo de 8 MB. Si excedes estos límites, recibirás un error de límite de velocidad 429.

Los fallos de autenticación devuelven un error 401 si la clave no es válida. Un error 402 indica crédito prepagado insuficiente. Los errores durante la generación no consumen tus tokens. La ventana de contexto incluye tokens de prompt y de finalización. El crédito no utilizado nunca expira, asegurando que tu saldo prepagado permanezca disponible para futuros proyectos.