Saltar al contenido principal

Autenticación

Usa una clave de API del espacio de trabajo para autenticar las solicitudes a la API pública de Fetch Hive.

Encabezado de autenticación

Envía tu clave de API en el encabezado Authorization en cada solicitud:
Authorization: Bearer YOUR_API_KEY
Fetch Hive usa el mismo encabezado bearer para los endpoints públicos de invocación y los endpoints públicos de recursos.

¿Cómo creo una clave de API?

Abre Settings y luego haz clic en API Keys. Si tu espacio de trabajo aún no tiene una clave predeterminada, haz clic en Create Default Key. Si quieres otra clave para un servicio o entorno específico, haz clic en Add API Key. Elige el entorno que deseas usar:
  • Production
  • Staging
  • Development
Copia la clave completa cuando Fetch Hive muestre Your New API Key. Después de que ese diálogo se cierre, Fetch Hive normalmente solo muestra el prefijo de la clave.

Solicitud de ejemplo

curl 'https://api.fetchhive.com/v1/prompt/invoke' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  --data-raw '{
    "deployment": "YOUR_DEPLOYMENT_NAME",
    "variant": "YOUR_VARIANT_NAME",
    "inputs": {
      "text": "Fetch Hive helps teams ship AI products faster."
    },
    "streaming": true
  }' \
  --compressed

¿Qué pasa cuando falla la autenticación?

Si la clave de API está ausente, es inválida o está revocada, Fetch Hive devuelve una respuesta de error.
{
  "error": "Invalid access."
}
Consulta Errores y límites de tasa para ver los códigos de estado comunes y las formas de error. Para la administración de claves de API en el panel, consulta Claves de API.