Kimicode: primera petición en cinco minutos

URL base y autenticación

Apunta tu cliente a nuestra URL base: https://api.kimicode.top/v1. Necesitas una clave de API para cada petición. Genera una haciendo clic en Obtener clave de API. Usa inicio de sesión con Google o email y contraseña. No se requiere teléfono. La clave se muestra al instante. Guárdala; hay una clave activa por cuenta. Si generas una nueva, la anterior deja de funcionar. Pásala en el header Authorization como token bearer.

Primera petición

Envía tu primer prompt al endpoint de completados de chat. Usa el ID de modelo uncensored. La API acepta formatos compatibles con OpenAI. Se introduce entrada y sale texto. Los errores y rechazos son gratuitos, así que solo pagas por el uso de tokens con éxito. Prueba la conectividad con un prompt simple.

Copiarcurl https://api.kimicode.top/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."}]
  }'

Si la clave no es válida, obtendrás un error 401. Si no tienes crédito, obtendrás un 402. Verifica el saldo de tu cuenta si las peticiones fallan inesperadamente.

Integración con SDK de Python

Usa el SDK oficial de OpenAI para Python. Establece la URL base en nuestro endpoint. Pasa tu clave de API. El cliente maneja automáticamente el formato de la petición. Esto funciona para cualquier lenguaje que admita clientes compatibles con OpenAI. Instala la biblioteca mediante pip. Configura el cliente con tu URL base y clave. Envía un mensaje usando el endpoint de completados de chat. La respuesta contiene el texto generado. Puedes analizar el contenido directamente desde el objeto de respuesta.

Copiarfrom openai import OpenAI

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

Asegúrate de que tu código maneje las excepciones de forma adecuada. Los problemas de red o los límites de peticiones pueden requerir reintentos.

Uso del SDK de Node.js

El SDK de Node.js funciona de manera idéntica. Importa el cliente. Configura la URL base y la clave de API. Llama al método de completados de chat. Pasa el ID del modelo y el array de mensajes. La estructura de la respuesta coincide con el formato de OpenAI. Extrae el contenido del mensaje del asistente. Este enfoque funciona para generación del lado del servidor o funciones de borde. No se necesita configuración adicional más allá del cambio de URL base.

Copiarimport OpenAI from "openai";

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

Maneja los errores verificando el código de estado. Los límites de peticiones devuelven 429. Fondos insuficientes devuelven 402.

Respuestas en streaming

Activa el streaming estableciendo stream: true. La API devuelve Server-Sent Events (SSE). Cada chunk contiene contenido parcial. Los detalles de uso de tokens aparecen en el último chunk. Esto reduce la latencia percibida en salidas largas. Maneja correctamente la terminación del stream. Cierra la conexión cuando el stream termina o ocurre un error. El streaming funciona con todos los clientes estándar que admiten SSE.

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

Asegúrate de que tu cliente almacene en búfer los fragmentos correctamente. Concatena el contenido para formar la respuesta final.

Límites, errores y contexto

La ventana de contexto es de 100.000 tokens en total. La salida máxima es de 32.000 tokens por petición. Establece 2.048 si max_tokens no está configurado. El límite de peticiones es de 300 peticiones por minuto por clave. El límite de concurrencia es de 8 peticiones simultáneas. El tamaño máximo del cuerpo de la petición es de 8 MB. Los errores incluyen 401 para claves inválidas, 402 por falta de crédito y 429 por límites de peticiones. El crédito no caduca. Los errores son gratuitos. Sin trampas de suscripción.