- Entra en el panel de desarrollador con tu cuenta de Kiuron (es gratis y te regalamos saldo para probar).
- 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).
- 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
| Campo | Qué es |
messages | Obligatorio. Lista de {"role": "user" | "assistant", "content": "…"} que termina con un mensaje del usuario. Hasta 50 mensajes. |
system | Opcional. Instrucciones para esta petición (se suman a las de la clave). |
model | Opcional. nube (rápido, por defecto) o nube-pro (más inteligente y más caro). |
max_tokens | Opcional. Longitud máxima de la respuesta (hasta 2.048). |
stream | Opcional. 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ódigo | Significa |
400 | La petición no es válida (revisa messages). |
401 | Clave no válida, borrada o en pausa. |
402 | No queda saldo: recárgalo en el panel. |
429 | Has llegado al límite diario que pusiste a la clave. |
502 / 503 | El 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
- El widget solo funciona en los dominios que indicas; en otras webs no se carga.
- Las claves secretas se guardan cifradas (solo las ves una vez) y puedes pausarlas o borrarlas cuando quieras.
- Los mensajes no se usan para entrenar modelos de IA ni para publicidad.
- Puedes poner un máximo de mensajes al día por clave para que nunca gastes de más.
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