kimiapikey.comDocumentación
API de Kimi: primera petición en cinco minutos
Obtén tu primera respuesta en menos de cinco minutos mediante la interfaz compatible con OpenAI. Esta guía cubre la configuración, la autenticación y el uso básico del modelo sin censura.
Requisitos previos
Para empezar, necesitas una clave de API de kimiapikey.com. Regístrate solo con un correo electrónico y contraseña; no se requiere tarjeta de crédito para la prueba. También necesitas un entorno de programación compatible con un SDK oficial o compatible instalado. Nuestra API sigue el formato de chat-completions de OpenAI, por lo que el código existente para GPT-3.5/4 suele funcionar con cambios mínimos. Asegúrate de que la versión de tu SDK sea lo suficientemente reciente para admitir el parámetro base_url.
URL base y autenticación
Nuestra API se encuentra en https://api.kimiapikey.com/v1. La autenticación se maneja mediante el encabezado estándar Authorization. Pasa tu clave como token Bearer. Esto funciona con cualquier cliente que acepte endpoints compatibles con OpenAI. Si usas un proxy o cliente personalizado, asegúrate de que reenvíe correctamente el encabezado Authorization. El ID de modelo que solicitarás es uncensored.
Primera petición
Envía una completación de chat simple para verificar tu configuración. Usa el comando curl a continuación, reemplazando YOUR_API_KEY con tu clave real. Esta petición envía un prompt corto al modelo uncensored. Si tiene éxito, recibirás una respuesta JSON que contiene la respuesta del modelo. Revisa la matriz choices para ver el texto generado. Si obtienes un error 401, tu clave no es válida o ha caducado.
SDK de Python
Usa la biblioteca oficial de Python de OpenAI para la integración más sencilla. Configura el base_url a nuestro endpoint y proporciona tu clave. Este ejemplo demuestra una llamada básica de generación de texto. Puedes ajustar el parámetro model si es necesario, aunque uncensored es el valor predeterminado. Este enfoque mantiene tu código portátil entre diferentes servicios compatibles con OpenAI.
SDK de Node.js
Para proyectos de JavaScript/TypeScript, usa el paquete npm openai. Configura el cliente con nuestra URL base y tu clave de API. Esto te permite realizar peticiones directamente desde tu entorno Node. La sintaxis refleja el SDK de Python, asegurando la consistencia si cambias de lenguaje. Recuerda manejar correctamente las respuestas asíncronas usando await.
Respuestas en streaming
Para salida en tiempo real, habilita el streaming en tu SDK. Esto envía fragmentos de texto a medida que se generan, reduciendo la latencia percibida. Usa la bandera stream en tu petición. El SDK generará respuestas parciales, lo que te permite actualizar la interfaz de usuario de forma incremental. Esto es ideal para interfaces de chat o generación de contenido extenso donde la retroalimentación inmediata es valiosa.
Límites y errores
Cada clave está limitada a 300 peticiones por minuto. Si superas este límite, recibirás un error 429. El cuerpo de tu petición no debe exceder 8 MB. Una ventana de contexto de 100.000 tokens se aplica a la suma del prompt y la completación. Los errores comunes incluyen 401 (clave no válida) y 402 (crédito insuficiente). Recarga desde el panel para seguir usando la API. Los créditos no caducan y no hay tarifas mensuales.
cURL
curl https://api.kimiapikey.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."}]
}'Python
from openai import OpenAI
client = OpenAI(base_url="https://api.kimiapikey.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)Node.js
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.kimiapikey.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);Streaming
stream = 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)Preguntas y respuestas
¿La API admite llamadas a funciones?
Sí, el endpoint admite llamadas a herramientas/funciones en el formato estándar de OpenAI. Puedes definir herramientas en tu petición y el modelo devolverá argumentos estructurados.
¿Qué pasa si supero el límite de peticiones?
Recibirás un error 429 Too Many Requests. Espera un momento y reintenta, o actualiza tu nivel de crédito prepago para mantener un mayor rendimiento.
¿Se entrena el modelo con mis datos?
No. Los prompts enviados a la API no se utilizan para el entrenamiento. Tus datos permanecen privados y no se usan para mejorar el modelo base.
Tu clave está a un formulario de distancia
Crea una cuenta, copia la clave, cambia la URL base. Esa es toda la configuración.
Especificaciones técnicas
Todos los límites y funciones reales de la API en un solo lugar: revísalos antes de recargar.
| Elemento | Valor |
|---|---|
| Formato | compatible con OpenAI: cualquier SDK de OpenAI funciona cambiando la base URL y la clave |
| ID del modelo | uncensored |
| Autenticación | Authorization: Bearer YOUR_KEY |
| Endpoints | POST /v1/chat/completions · GET /v1/models |
| Base URL | https://api.kimiapikey.com/v1 |
| Salida máxima | hasta el resto de la ventana de 100.000 tokens; max_tokens opcional (sin límite aparte) |
| Parámetros | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| Llamadas a funciones | sí: tools, tool_choice; la respuesta trae tool_calls, también en streaming; resultados como role: tool |
| Streaming | sí: server-sent events; el último fragmento incluye el uso de tokens |
| Ventana de contexto | 100.000 tokens (entrada + salida) |
| Modo JSON | response_format: {"type": "json_object"} |
| Concurrencia | 8 peticiones a la vez por clave |
| Límite de peticiones | 300 por minuto por clave |
| Cabeceras | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| Tamaño de petición | hasta 8 MB |
| Precio | $0,15 por 1M tokens de entrada · $0,50 por 1M de salida |
| Facturación | crédito prepago por uso real; errores y rechazos no se cobran |
| Bono | +5 % desde $50, +10 % desde $100, +15 % desde $200 |
| Caducidad | el crédito pagado no caduca, sin suscripción |
| Recarga | USDT (TRC20) o USDC (Base), cualquier importe entero de $20 a $500 |
| Prueba gratis | $0,50 durante 7 días, sin tarjeta · Clave de prueba: 2 solicitudes paralelas, 60 por minuto; límites completos (8 y 300) tras la primera recarga |
| Claves | una clave activa por cuenta; una nueva reemplaza a la anterior |
| Acceso | Google o correo y contraseña |
| Contenido | contenido adulto permitido; se rechaza el contenido sexual con menores |
Errores y qué hacer
Los errores llegan como JSON con un type fijo; las peticiones fallidas o rechazadas no se cobran.
| Código | Tipo | Significado |
|---|---|---|
400 | bad_request | JSON inválido, mensajes vacíos, parámetro incorrecto o contexto demasiado largo |
401 | missing_key · invalid_key · key_revoked | falta la clave, es incorrecta o fue reemplazada |
402 | no_credit | sin crédito: recarga y sigue al instante |
403 | content_blocked | contenido sexual con menores: rechazado, no se cobra |
404 | not_found | endpoint desconocido |
413 | request_too_large | cuerpo mayor de 8 MB |
429 | rate_limited · concurrency | más de 300/min o 8 en paralelo: espera y reintenta |
503 | upstream_busy | modelo ocupado: reintenta en unos segundos |