Guía de inicio rápido de la API Kimi

Prerrequisitos: instalación del SDK

Instala el SDK oficial para tu lenguaje para manejar la autenticación y la serialización automáticamente. Nuestra API se adhiere al estándar de OpenAI, por lo que cualquier biblioteca cliente compatible funciona con cambios mínimos de configuración.

Para Python, instala la biblioteca mediante pip. Para Node.js, usa npm o yarn. Estas herramientas gestionan el cliente HTTP y el análisis JSON por ti.

Autenticación: Configuración de tu clave de API kimi

Obtenga su clave del panel y pásela como Authorization header. Usa la URL base https://api.apikimi.cc/v1 para todas las solicitudes.

Almacena la clave de forma segura en tus variables de entorno o archivos de configuración. El formato del encabezado es Bearer YOUR_API_KEY.

Enviar tu primera solicitud

Envía una solicitud POST a /v1/chat/completions con tu ID del modelo uncensored. La respuesta devuelve el texto generado directamente.

Asegúrate de establecer el model field correctly. The API returns raw output without content refusals for lawful topics.

Respuestas en streaming

Habilita la transmisión estableciendo stream: true en el cuerpo de tu solicitud. Esto devuelve fragmentos como Eventos Enviados por el Servidor (SSE).

Analiza el flujo SSE para mostrar los tokens en tiempo real. El fragmento final incluye las estadísticas de uso de tokens para facturación.

Configuración de la Llamada de Función

Define herramientas en el tools array dentro de tu solicitud. El modelo devuelve llamadas a herramientas en lugar de texto directo cuando es apropiado.

Maneja las llamadas a herramientas en la lógica de tu aplicación y envía los resultados de vuelta a la API para su procesamiento adicional. Soporte para tool_choice permite una aplicación estricta.

Gestión de errores y límites

Maneja los errores HTTP estándar: 401 para claves inválidas, 402 para saldo insuficiente y 429 para límites de velocidad. La ventana de contexto admite un total de 100,000 tokens.

La salida máxima es de 16,000 tokens por solicitud. Los errores no consumen crédito. Ajusta tu lógica de reintento según el código de error.

cURL

Copycurl https://api.apikimi.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the key differences between Rust and Go memory management"}]
  }'

Python

Copyfrom openai import OpenAI

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

Transmisió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)