Inicio rápido para usuarios de Kimicode

Requisitos previos

Antes de escribir código, crea una cuenta en kimicode.cc con Google o correo electrónico. Recibirás una única clave de API de inmediato. No se requiere verificación por teléfono ni tarjeta de crédito. Tu cuenta comienza con $0.50 en crédito de prueba válido por siete días. Si necesitas más capacidad, recarga mediante criptomonedas (USDT en TRC20 o USDC en Base) a partir de $10. El crédito no caduca y los errores o rechazos no consumen tokens.

Asegúrate de que tu entorno de desarrollo tenga Node.js (v18+) o Python 3.8+. Esta API sigue estrictamente la especificación del cliente openai, lo que significa que puedes cambiar nuestro endpoint sin modificar la lógica de tu biblioteca. Ofrecemos un único modelo sin censura con el ID uncensored.

Instalar SDK

Instala el SDK oficial de OpenAI para tu lenguaje preferido. Esto garantiza la compatibilidad con nuestras funciones de streaming, llamadas a funciones y modo JSON.

Para Python, usa pip para instalar la biblioteca estándar:

• pip install openai

Para Node.js, instala el paquete npm:

• npm install openai

Estas bibliotecas manejan automáticamente el formato HTTP. No necesitas un cliente específico del proveedor. La API kimicode acepta parámetros estándar como temperature, top_p y max_tokens.

Inicializar cliente

Configura tu objeto cliente con la URL base kimicode y tu clave de API. La URL base es https://api.kimicode.cc/v1. Establece api_key con el valor que recibiste al registrarte. Esta configuración reemplaza el endpoint predeterminado api.openai.com.

• URL base: https://api.kimicode.cc/v1
• Modelo: uncensored
• Autenticación: Token Bearer a través de api_key

No mezcles esta clave con otros proveedores. Funciona exclusivamente con el endpoint kimicode. El cliente verificará la clave en la primera petición. Si la clave no es válida, recibirás un error 401 inmediatamente.

Hacer una petición

Envía una petición de chat completion estándar. El ID del modelo debe ser uncensored. Puedes ajustar max_tokens hasta 32,000. Si se omite, el valor predeterminado es 2,048. La ventana de contexto es de 100,000 tokens en total para prompt y completion combinados.

• Entrada: Mensajes de texto en la matriz messages.
• Salida: Respuesta de texto en choices[0].message.content.

Este endpoint admite modo JSON mediante response_format: {"type": "json_object"}. No admite embeddings, imágenes ni audio. Concéntrate en la generación de texto de alta calidad sin rechazos de contenido para temas adultos legales.

Respuestas en streaming

Habilita el streaming estableciendo stream: true. La API devuelve Server-Sent Events (SSE). Cada fragmento contiene texto parcial. Las estadísticas de uso de tokens se incluyen en el último fragmento del stream. Esto permite la visualización en tiempo real de la salida sin esperar a la respuesta completa.

• Bandera de streaming: Establecer a true en el cuerpo de la petición.
• Tipo de evento: chat.completion.chunk
• Datos: Contiene delta.content para las partes de texto.

El streaming no cambia la facturación. Pagas por el total de tokens procesados. Los errores durante el streaming se manejan de forma adecuada. Si la conexión se cae, puedes reiniciar la petición. El modelo sin censura mantiene la coherencia incluso en transmisiones largas dentro del límite de 100k.

Límites, errores y contexto

Monitorea tus límites de uso: 300 peticiones por minuto por clave, 8 peticiones concurrentes y un cuerpo de petición de 8 MB. Si excedes el límite de peticiones, recibes un error 429. Si se agota tu crédito prepago, recibes un error 402; recarga mediante criptomonedas para reanudar. Un error 401 indica una clave de API inválida o faltante. Ten en cuenta que las peticiones fallidas y los rechazos no consumen tokens. El límite estricto de contenido bloquea el contenido sexual que involucra menores. Se permite todo el contenido adulto legal restante.

Llamadas a funciones

Define herramientas en el parámetro tools. El modelo devuelve llamadas a herramientas en la respuesta. Usa tool_choice para forzar un comportamiento específico. Esta función funciona idénticamente al estándar de OpenAI. Analiza las llamadas a herramientas en tu código y ejecútalas. Envía los resultados de nuevo en mensajes posteriores. La API kimicode maneja las definiciones de herramientas de manera eficiente. Asegúrate de que tu esquema JSON sea válido. Las llamadas a funciones no requieren créditos adicionales más allá del uso de tokens. Es ideal para construir agentes o flujos de trabajo de extracción de datos estructurados.

cURL

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

Python

Copyfrom openai import OpenAI

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

Streaming

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)