Saltar al contenido
kiuronIA, inicio

Pon Kiuron en tu web o en tu app

Un asistente con IA que responde a tus clientes con tus instrucciones, en una línea de código. O la API, para integrarlo donde quieras. Pagas solo lo que usas y te regalamos saldo para empezar.

Crear mis clavesVer ejemplos

Widget para tu web

Un chat flotante en tu web, listo en dos minutos y sin programar.

  • Una línea de HTML: funciona en WordPress, Shopify, Wix o tu propia web
  • Tu nombre, tu color, tu saludo y tus instrucciones
  • Solo funciona en los dominios que tú indiques
  • Límite diario opcional para controlar el gasto

API para programadores

Usa Kiuron desde tu servidor o tu aplicación con una petición HTTP.

  • Respuesta completa o en streaming
  • Modelo normal o Pro
  • Instrucciones de sistema por clave o por petición
  • Uso y coste en cada respuesta

El widget, paso a paso

  1. Entra en el panel de desarrollador con tu cuenta de Kiuron (es gratis y te regalamos saldo para probar).
  2. Pulsa Widget para tu web: ponle nombre, tus dominios, el color, el saludo y las instrucciones (quién es tu negocio, qué responde y qué no).
  3. Copia el código y pégalo antes de </body> en tu web.
<script src="https://kiuron.com/widget.js"
        data-clave="kiu_pub_…"
        data-color="#8fdc5a" async></script>

Opcional: data-texto="¿Te ayudo?" muestra una etiqueta junto al botón y data-posicion="izquierda" lo coloca a la izquierda. En el móvil, el chat se abre a pantalla completa.

La API

Crea una clave de API en el panel. Es secreta: úsala solo desde tu servidor, nunca en el código de una web o una app que vea el público.

Petición

curl https://kiuron.com/nube/v1/chat \
  -H "Authorization: Bearer kiu_sk_…" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [{"role": "user", "content": "Escribe un eslogan para una panadería"}],
    "system": "Responde en una sola línea."
  }'

Respuesta

{
  "texto": "Pan de verdad, recién hecho cada mañana.",
  "modelo": "nube",
  "cortada": false,
  "uso": {"entrada": 412, "salida": 14, "coste": 0.000521, "moneda": "EUR"}
}

Parámetros

CampoQué es
messagesObligatorio. Lista de {"role": "user" | "assistant", "content": "…"} que termina con un mensaje del usuario. Hasta 50 mensajes.
systemOpcional. Instrucciones para esta petición (se suman a las de la clave).
modelOpcional. nube (rápido, por defecto) o nube-pro (más inteligente y más caro).
max_tokensOpcional. Longitud máxima de la respuesta (hasta 2.048).
streamOpcional. Con true, la respuesta llega a trozos: una línea JSON por trozo ({"texto": "…"}) y al final {"fin": true, "uso": {…}}.

JavaScript (Node.js)

const r = await fetch("https://kiuron.com/nube/v1/chat", {
  method: "POST",
  headers: {"Authorization": "Bearer " + process.env.KIURON_CLAVE, "Content-Type": "application/json"},
  body: JSON.stringify({messages: [{role: "user", content: "Resume este texto: …"}]})
});
const {texto, uso} = await r.json();

Python

import os, requests
r = requests.post("https://kiuron.com/nube/v1/chat",
    headers={"Authorization": f"Bearer {os.environ['KIURON_CLAVE']}"},
    json={"messages": [{"role": "user", "content": "Traduce al inglés: buenos días"}]})
print(r.json()["texto"])

PHP

$ch = curl_init('https://kiuron.com/nube/v1/chat');
curl_setopt_array($ch, [CURLOPT_POST => true, CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('KIURON_CLAVE'), 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => json_encode(['messages' => [['role' => 'user', 'content' => 'Hola']]])]);
echo json_decode(curl_exec($ch), true)['texto'];

Errores

CódigoSignifica
400La petición no es válida (revisa messages).
401Clave no válida, borrada o en pausa.
402No queda saldo: recárgalo en el panel.
429Has llegado al límite diario que pusiste a la clave.
502 / 503El servicio no ha podido responder: vuelve a intentarlo en unos segundos.

Todas las respuestas de error son JSON: {"error": "…"}.

Precios

Sin cuotas ni permanencia: recargas saldo (desde 10 €, IVA incluido, con factura) y cada respuesta descuenta lo que cuesta según los tokens que usa. Con el modelo normal, una pregunta corta con su respuesta sale por unas décimas de céntimo. Los precios exactos por millón de tokens están en el panel. El saldo no caduca y al crear tu cuenta de desarrollador te regalamos saldo para probar.

Seguridad y privacidad

Preguntas frecuentes

¿Cuánto cuesta?

Pagas solo lo que usas, con saldo prepagado desde 10 €. Una pregunta corta con el modelo normal cuesta unas décimas de céntimo. Al empezar te regalamos saldo para probar.

¿Necesito saber programar para el widget?

No. Copias una línea de código y la pegas en tu web. Funciona en WordPress, Shopify, Wix y cualquier web.

¿Puedo decidir qué responde?

Sí. Escribes las instrucciones: quién es tu negocio, qué datos debe conocer y de qué no debe hablar.

¿Qué pasa si se acaba el saldo?

El widget deja de responder y la API devuelve el error 402 hasta que recargues. Nunca se cobra nada sin saldo.

Crear mis claves