Autenticación

​

Tipos de claves

• Claves de API de Gateway: permiten llamar a los endpoints de modelos, proveedores y generaciones disponibles en tu espacio de trabajo.
• Claves de API de administración: permiten llamar a las API de administración. Consulta Claves de API de administración.

​

Formato del encabezado

Authorization: Bearer phaseo_v1_sk_<kid>_<secret>

const response = await fetch("https://api.phaseo.app/v1/chat/completions", {
	method: "POST",
	headers: {
		Authorization: `Bearer ${process.env.PHASEO_API_KEY}`,
		"Content-Type": "application/json",
	},
	body: JSON.stringify({
		model: "openai/gpt-5-nano",
		messages: [
			{ role: "system", content: "You are a helpful assistant." },
			{
				role: "user",
				content: "Summarize the drawbacks to AI.",
			},
		],
	}),
});

​

Lista de comprobación para gestionar claves

​

Errores habituales de autenticación

• 401 No autorizado: falta la clave, no es válida o pertenece a un espacio de trabajo deshabilitado.
• 403 Prohibido: la clave existe, pero no puede acceder al proveedor o modelo solicitado.
• 429 Too Many Requests: la clave o el espacio de trabajo ha superado un límite. Consulta Límites de solicitudes.
• Errores 5xx: vuelve a intentarlo con retroceso exponencial y contacta con soporte si el problema persiste.