Cómo conectar la API de Claude a un sitio web en PHP
Foto: Retro-Computing Society of Rhode Island · CC BY-SA 4.0 · Redimensionada
Integrar un modelo de inteligencia artificial en un sitio web es más sencillo de lo que parece. En esta guía conectaremos la API de Claude, de Anthropic, a un sitio web con PHP en el servidor y JavaScript en el navegador, siguiendo buenas prácticas de seguridad.
1. Obtenga una clave de API
Cree una cuenta en la consola de desarrolladores de Anthropic, configure la facturación y genere una clave de API. Trátela como una contraseña: quien la tenga puede usar su cuenta y generar costos.
Foto: Taylor Ramos · CC BY 2.0 · Recortada2. Regla de oro: la clave nunca va en el navegador
Si la clave se escribe en el JavaScript de la página, cualquier visitante puede verla. La arquitectura correcta es: navegador → su servidor PHP → API de Claude.
3. El endpoint en PHP
Guarde la clave en una variable de entorno o en un archivo de configuración fuera de la carpeta pública, y cree chat.php:
<?php
header('Content-Type: application/json; charset=utf-8');
$entrada = json_decode(file_get_contents('php://input'), true);
$mensajes = $entrada['mensajes'] ?? [];
// Validaciones básicas: máximo 20 mensajes y 2.000 caracteres cada uno
$mensajes = array_slice($mensajes, -20);
foreach ($mensajes as &$m) {
$m = [
'role' => $m['role'] === 'assistant' ? 'assistant' : 'user',
'content' => mb_substr((string) $m['content'], 0, 2000),
];
}
unset($m);
$ch = curl_init('https://api.anthropic.com/v1/messages');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_TIMEOUT => 60,
CURLOPT_HTTPHEADER => [
'content-type: application/json',
'x-api-key: ' . getenv('ANTHROPIC_API_KEY'),
'anthropic-version: 2023-06-01',
],
CURLOPT_POSTFIELDS => json_encode([
'model' => 'claude-3-5-sonnet-20241022',
'max_tokens' => 600,
'system' => 'Eres el asistente del sitio web de una empresa de diseño web en Colombia. '
. 'Responde en español, de forma breve y amable. No inventes precios.',
'messages' => $mensajes,
]),
]);
$respuesta = json_decode(curl_exec($ch), true);
$codigo = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
if ($codigo !== 200) {
http_response_code(502);
echo json_encode(['error' => 'El asistente no está disponible en este momento.']);
exit;
}
echo json_encode(['respuesta' => $respuesta['content'][0]['text']]);
4. El chat en el navegador
<div id="chat"></div>
<form id="formChat">
<input id="pregunta" placeholder="Escriba su pregunta" required>
<button>Enviar</button>
</form>
<script>
const historial = [];
const chat = document.getElementById('chat');
function agregar(rol, texto) {
const p = document.createElement('p');
p.textContent = (rol === 'user' ? 'Usted: ' : 'Asistente: ') + texto;
chat.appendChild(p);
}
document.getElementById('formChat').addEventListener('submit', async (e) => {
e.preventDefault();
const campo = document.getElementById('pregunta');
historial.push({ role: 'user', content: campo.value });
agregar('user', campo.value);
campo.value = '';
const res = await fetch('chat.php', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ mensajes: historial })
});
const datos = await res.json();
const texto = datos.respuesta || datos.error;
if (datos.respuesta) historial.push({ role: 'assistant', content: texto });
agregar('assistant', texto);
});
</script>
Observe que se usa textContent y no innerHTML, para que ningún texto se interprete como código.
5. Elegir el modelo
Anthropic ofrece modelos de distintos tamaños. Claude 3.5 Sonnet equilibra calidad y costo; Claude 3.5 Haiku es más rápido y económico, ideal para preguntas sencillas y alto volumen. Revise la documentación oficial, porque los nombres de los modelos cambian con cada nueva versión.
6. Controle los costos y el abuso
- Limite la longitud de los mensajes y del historial.
- Defina
max_tokensacorde con la respuesta esperada. - Agregue un límite de solicitudes por IP o por sesión.
- Configure alertas y límites de gasto en la consola.
- Use el almacenamiento en caché de prompts si envía siempre las mismas instrucciones largas.
7. Mejoras siguientes
Streaming para mostrar la respuesta mientras se genera, RAG para responder con los documentos de la empresa, registro de conversaciones para mejorar las instrucciones y un botón para pasar a un asesor humano.
¿Necesita ayuda con su sitio web? Contáctenos: somos expertos en sitios web y posicionamiento, con más de 21 años de experiencia.