Documentación de la API: Endpoints compatibles con OpenAI

Autenticación & URL base

Accede a la API estableciendo tu clave única y la URL base en tus variables de entorno. El endpoint se encuentra en https://api.apikeykimi.com/v1.Debes incluir el encabezado Authorization: Bearer YOUR_API_KEY con cada solicitud. Esta clave se genera al instante al registrarse con Google o correo electrónico. Es la única credencial necesaria para la autenticación. No es necesario configurar ámbitos ni permisos.

Copycurl https://api.apikeykimi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "convert this json object to python dictionary syntax"}]
  }'

Endpoint Chat Completions

Envía mensajes al modelo usando el estándar /v1/chat/completions endpoint. Especifica el ID del modelo como uncensored en el cuerpo de la solicitud. La API devuelve texto generado basado en tu historial de prompts. Puedes ajustar parámetros como temperatura y top_p para controlar la creatividad. El modelo soporta llamada de funciones y modo JSON para salidas estructuradas.

Copyfrom openai import OpenAI

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

Respuestas en streaming (SSE)

Habilitar entrega de tokens en tiempo real estableciendo stream: true en tu solicitud. El servidor devuelve un flujo de Server-Sent Events. Cada fragmento contiene texto parcial hasta que la respuesta esté completa. Esto es ideal para interfaces de chat y pantallas de codificación en vivo. Los detalles del uso de tokens aparecen en el último fragmento del flujo.

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)

Llamada de funciones y modo JSON

Define herramientas o fuerza la salida JSON mediante response_format parámetro. Establece json_object para garantizar respuestas JSON válidas. También puedes pasar definiciones de herramientas para la llamada de funciones. El modelo se adhiere estrictamente a estas restricciones. Esto permite una integración confiable con servicios externos. Usa tool_choice para controlar cómo se invocan las herramientas.

Límites de Tokens & Restricciones

La ventana de contexto admite hasta 100.000 tokens para entrada y salida combinadas. La salida máxima por solicitud es de 16.000 tokens. Si no estableces max_tokens, el límite predeterminado es de 2,048 tokens. Las solicitudes están limitadas a 8 MB en tamaño de cuerpo. Estás limitado a 300 solicitudes por minuto. Solo 8 solicitudes pueden ejecutarse simultáneamente por clave.

Gestión de errores y límites de uso

Gestiona los errores comprobando el código de estado HTTP. Un 401 indica una clave API inválida o caducada. Un error 402 significa que tu crédito prepagado se ha agotado. Una respuesta 429 indica que has superado el límite de frecuencia de 300 solicitudes por minuto. Los errores y las denegaciones no consumen tokens. Comprueba tu saldo en el panel para evitar interrupciones.

Node.js

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.apikeykimi.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);