ES ▾
Obtener clave de API

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.

Obtener clave de API

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.

Obtener clave de APILeer la documentación

Especificaciones técnicas

Todos los límites y funciones reales de la API en un solo lugar: revísalos antes de recargar.

ElementoValor
Formatocompatible con OpenAI: cualquier SDK de OpenAI funciona cambiando la base URL y la clave
ID del modelouncensored
AutenticaciónAuthorization: Bearer YOUR_KEY
EndpointsPOST /v1/chat/completions · GET /v1/models
Base URLhttps://api.kimiapikey.com/v1
Salida máximahasta el resto de la ventana de 100.000 tokens; max_tokens opcional (sin límite aparte)
Parámetrostemperature, top_p, stop, seed, presence_penalty, frequency_penalty
Llamadas a funcionessí: tools, tool_choice; la respuesta trae tool_calls, también en streaming; resultados como role: tool
Streamingsí: server-sent events; el último fragmento incluye el uso de tokens
Ventana de contexto100.000 tokens (entrada + salida)
Modo JSONresponse_format: {"type": "json_object"}
Concurrencia8 peticiones a la vez por clave
Límite de peticiones300 por minuto por clave
CabecerasX-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency
Tamaño de peticiónhasta 8 MB
Precio$0,15 por 1M tokens de entrada · $0,50 por 1M de salida
Facturacióncrédito prepago por uso real; errores y rechazos no se cobran
Bono+5 % desde $50, +10 % desde $100, +15 % desde $200
Caducidadel crédito pagado no caduca, sin suscripción
RecargaUSDT (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
Clavesuna clave activa por cuenta; una nueva reemplaza a la anterior
AccesoGoogle o correo y contraseña
Contenidocontenido 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ódigoTipoSignificado
400bad_requestJSON inválido, mensajes vacíos, parámetro incorrecto o contexto demasiado largo
401missing_key · invalid_key · key_revokedfalta la clave, es incorrecta o fue reemplazada
402no_creditsin crédito: recarga y sigue al instante
403content_blockedcontenido sexual con menores: rechazado, no se cobra
404not_foundendpoint desconocido
413request_too_largecuerpo mayor de 8 MB
429rate_limited · concurrencymás de 300/min o 8 en paralelo: espera y reintenta
503upstream_busymodelo ocupado: reintenta en unos segundos