ES ▾
Obtener clave de API

kimiapikey.comGuía

URL base de la API Moonshot: apunta tu código a otro lado

La URL base de la API de moonshot es solo una cadena en tu cliente estilo OpenAI, y cambiarla es cómo haces que el mismo código apunte a un proveedor diferente. Esta página muestra dónde se encuentra esa cadena en Python, Node, curl y herramientas comunes, y cómo apuntarla a un endpoint alternativo.

Actualizado

Un cable movido entre dos puertos en un panel de conmutación, que ilustra un cambio en la URL base de la API
Ilustración isométrica de un editor de código conectado con un cable brillante a un servidor de API

Puntos clave

  • La URL base es un único ajuste; el cuerpo de la petición sigue en el formato de chat de OpenAI.
  • Cambia tres cosas cuando cambies de proveedor: URL base, clave de API, ID del modelo.
  • Nuestro endpoint es https://api.kimiapikey.com/v1 y el ID del modelo es uncensored.
  • Es un modelo alojado de forma independiente, no el servicio oficial de Moonshot, así que vuelve a probar tus prompts.

Lo que realmente hace una URL base

Los clientes compatibles con OpenAI construyen cada petición a partir de dos partes: una URL base y una ruta. El SDK las une, por lo que una llamada a chat.completions.create se convierte en un POST a <base_url>/chat/completions. Los proveedores que siguen este formato, Moonshot entre ellos, publican su propia URL base en su documentación. Búscala allí en lugar de copiarla de un hilo de foro, porque es el único valor que no puedes adivinar.

Por tanto, cambiar de proveedor requiere tres ediciones y nada más:

  1. La URL base, que decide dónde va la petición.
  2. La clave de API, que se emite por proveedor y solo funciona en los servidores de ese proveedor.
  3. El ID del modelo, porque cada proveedor nombra sus modelos de forma diferente.

Los mensajes, roles, streaming, herramientas y modo JSON mantienen la misma estructura, por eso la migración es breve. Cualquier cosa que dependa de una función específica del proveedor, como una herramienta de búsqueda web integrada, necesitará un manejo separado.

También ayuda a mantener los tres valores juntos en un bloque de configuración o un archivo de entorno por proveedor. Cuando la URL base, la clave y el ID del modelo están juntos, volver atrás es un cambio de una línea, y evitas el estado de migración a medias donde una nueva clave se empareja con una dirección antigua.

Python: el paquete openai

En Python se establece la URL base al crear el cliente. Este ejemplo se conecta al endpoint de este sitio:

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": "Explain a base URL in one sentence."}],
)
print(resp.choices[0].message.content)

Si prefieres mantener el código libre de ajustes, usa el entorno. El SDK lee OPENAI_BASE_URL y OPENAI_API_KEY cuando llamas a OpenAI() sin argumentos, así que un despliegue puede cambiar de proveedor sin cambiar el código. Ten en cuenta que esto también significa que una variable que quedó en tu shell puede sobrescribir un valor que escribiste en el archivo.

Node y curl

El paquete oficial de JavaScript usa el mismo nombre de opción, escrito en camel case:

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: "Hello" }],
  stream: false,
});
console.log(resp.choices[0].message.content);

Sin SDK en absoluto, la URL base es simplemente el inicio de la dirección:

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":"Hello"}]}'

El mismo endpoint también acepta POST /v1/responses, y GET /v1/models lista lo que sirve. La autenticación es un token Bearer en el encabezado Authorization en todos los casos.

Editores y interfaces de chat

Las herramientas GUI exponen la URL base bajo diferentes etiquetas: "API base", "Sobrescribir URL base de OpenAI", "Endpoint personalizado" o "URL del proveedor". El valor que pegas es la misma cadena que en el código anterior, terminando en /v1. No pegues la dirección completa /chat/completions a menos que la herramienta diga que quiere la URL completa.

Después de guardar, añade el ID del modelo a mano si la herramienta no obtiene una lista. Algunos editores validan la clave contra un proveedor fijo y rechazan valores personalizados, en cuyo caso busca un ajuste que active primero el modo personalizado o compatible con OpenAI. El artículo sobre usar una clave API estilo Kimi en Cursor explica una de estas herramientas en detalle.

Qué cambia cuando cambias de proveedor

Un formato coincidente no significa un comportamiento coincidente. Antes de mover tráfico de producción, verifica estos puntos uno por uno:

  • Estilo de salida. Un modelo diferente escribe de forma diferente. Ejecuta tus prompts reales, no un ejemplo de juguete.
  • Tamaño del contexto. El endpoint aquí tiene una ventana de 100.000 tokens para prompt más completion. Si tu configuración actual envía prompts más largos, recórtalos primero.
  • Límites. Una clave completa permite 8 peticiones simultáneas y 300 por minuto. Por encima de cualquiera de estos límites obtienes HTTP 429, con rate_limited o concurrency como código.
  • Funcionalidades. Se admite streaming sobre SSE, llamadas a funciones y modo JSON. No se admiten generación de imágenes, audio y video, incrustaciones ni ajuste fino; esta es una API solo de texto.
  • Nomenclatura. El servicio ejecuta un modelo de pesos abiertos elegido para responder sin rechazos de contenido para uso adulto legal. No es la API oficial de Moonshot ni un enrutador entre proveedores.

Una forma neutral de comparar es registrar las mismas diez peticiones a través de ambos endpoints y leer las respuestas lado a lado. Eso lleva minutos y ahorra conjeturas.

Errores en la URL base y cómo se ven

La mayoría de los fallos después de un cambio provienen de la dirección, no de la clave. Aquí te mostramos cómo se manifiesta cada error y cómo repararlo.

ErrorSíntomaSolución
Solo host, sin /v1404 en cada llamadaAñade /v1 al final
Ruta completa pegada404 con una ruta duplicada en el errorRecorta la dirección a /v1
Barra final más unión de rutas manualDoble barra en la URLDeja que el SDK una la ruta
Clave antigua, URL nueva401Usa la clave emitida por el nuevo proveedor
URL antigua, clave nueva401 del proveedor antiguoBusca en el repositorio y en el shell la dirección antigua
http:// en lugar de https://Error de redirección o conexiónUsa https en todas partes

Una forma rápida de encontrar restos es buscar en tu proyecto y en la configuración de despliegue el nombre de host antiguo. Busca en archivos .env, variables de CI, archivos de Docker compose y cualquier configuración del editor, ya que una sola copia olvidada es suficiente para enviar algo de tráfico al proveedor antiguo.

Streaming y herramientas después del cambio

Establece stream: true y la respuesta llega como eventos enviados por el servidor, con el uso de tokens reportado al final. Las llamadas a funciones usan los campos habituales tools y tool_choice, con tool_calls y resultados enviados de forma en streaming como mensajes con role: "tool". Si tu código ya los maneja para el proveedor anterior, debería seguir funcionando; confirma esto ejecutando una llamada en streaming y una llamada a función antes de cambiar completamente. Recuerda que una petición en streaming mantiene su slot de concurrencia hasta que finalice el flujo.

Verificación de costes antes de cambiar

La facturación aquí es por token: $0,15 por 1M de tokens de entrada y $0,50 por 1M de tokens de salida, desde crédito prepago, sin suscripción. Las peticiones fallidas o rechazadas no se cobran, y el crédito no caduca. Para las tarifas de otro proveedor, consulta su página de precios actual, ya que esas cambian.

Un ejemplo práctico. Supongamos que una petición tiene 2.000 tokens de entrada y 500 tokens de salida:

  • Entrada: 2.000 / 1.000.000 x $0,15 = $0,0003
  • Salida: 500 / 1.000.000 x $0,50 = $0,00025
  • Total: $0,00055 por petición, así que 1.000 peticiones cuestan $0,55

La recarga mínima es de $20, y las recargas mayores añaden un bono: +5% desde $50, +10% desde $100 y +15% desde $200. Se acepta cripto (USDT en TRC20, USDC en Base). Los detalles completos están en la página de precios, y el desglose centrado en Kimi está en Precios de la clave de API de Kimi.

Obtén una clave y ejecuta la primera petición

Regístrate con Google o con correo electrónico y contraseña, luego abre la página de clave de API. Los usuarios nuevos pueden reclamar $0,50 de crédito de prueba con un solo clic, uno por persona, válido por 7 días y sin necesidad de tarjeta. Las claves de prueba están limitadas a 2 peticiones simultáneas y 60 por minuto, lo cual es suficiente para una prueba.

Pega la clave en el fragmento de Python anterior, ejecútalo y confirma que recibes texto. La página de documentación lista todos los parámetros, y los encabezados de respuesta X-Request-Id y X-Balance-USD ayudan con la depuración y el seguimiento del saldo. Los prompts enviados al servicio no se usan para entrenamiento.

Preguntas frecuentes

¿Es el modelo el mismo que el Kimi oficial de Moonshot?
No, alojamos un modelo de pesos abiertos que está ajustado para ser sin censura. No es GPT, Claude, Gemini, Grok, DeepSeek ni ningún otro modelo de proveedor. Es un modelo distinto ejecutado en nuestros propios servidores.

¿Entrenan con mis datos?
No. Tus prompts y completados no se utilizan para el entrenamiento. Valoramos la privacidad y la transparencia, por lo que tus datos siguen siendo tuyos.

¿Cuáles son los límites de peticiones?
Estás limitado a 300 peticiones por minuto por clave. El tamaño máximo del cuerpo de la petición es de 8 MB. Estos límites están diseñados para garantizar un rendimiento estable para todos los usuarios.

¿Cuál es la política de contenido?
El modelo es sin censura respecto a temas adultos, controversiales y creativos. Sin embargo, bloqueamos contenido sexual que involucre menores. Este es un límite estricto que siempre se aplica, independientemente de tu nivel de suscripción.

Preguntas y respuestas

¿Necesito cambiar mi código cuando cambio la URL base?

Normalmente solo tres valores: URL base, clave de API e ID del modelo. El formato del mensaje, el streaming y las llamadas a funciones se mantienen igual siempre que el nuevo proveedor los soporte.

¿Debe terminar la URL base con /v1?

Sí para este endpoint: https://api.kimiapikey.com/v1. El SDK añade /chat/completions automáticamente, así que no lo incluyas.

¿Es esta la API oficial de Moonshot?

No. Es un modelo de pesos abiertos alojado de forma independiente detrás de una API compatible con OpenAI. No es el servicio de Moonshot ni un enrutador entre proveedores.

¿Dónde encuentro el ID del modelo?

Llama a GET /v1/models con tu clave. En este endpoint el ID del modelo es uncensored.

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