Instalación y llaves
Revisión del 9 de noviembre de 2026 contra huggingface.co/docs (PRO, Inference Providers, ZeroGPU, tokens y CLI). La llave vive en el baúl «Claude» de 1Password y en el .env local; nunca en este sitio.
| Estado | Pieza | Evidencia |
|---|---|---|
| ✅ | Token y cuenta PRO | Token fine-grained «claude-m5-inference» válido; la cuenta responde isPro = true. |
| ✅ | Inference Providers | Permiso inference.serverless.write; límite PRO de 2,500 peticiones cada 5 min. |
| ✅ | Spaces públicos (ZeroGPU) | gradio_client con el mismo token; la cuota de 40 min se carga a la cuenta. |
| ✅ | Librería huggingface_hub | Versión 2.4.0 vía uv run, sin instalación global. |
| ⚠️ | CLI hf | No está instalado globalmente; corre con uv run --with "huggingface_hub[cli]" hf … |
| ⚠️ | fal por la librería | huggingface_hub 2.4.0 arma mal la URL del resultado de fal (KeyError «video»); se usa la cola de fal por el router. |
| ❌ | Inference Endpoints | El token no tiene inference.endpoints.read: 403. |
| ❌ | HF Jobs | Sin permiso de jobs: 403. |
| ❌ | Repos privados y modelos restringidos | Sin lectura de repos; canReadGatedRepos = false. |
| ➖ | Consumo por API | No existe para cuentas personales; se ve en huggingface.co/settings/inference-providers/overview. |
Lo que la documentación cambia respecto a lo que creíamos
- Pasar los 40 min de ZeroGPU no se detiene: se cobra de los créditos a US$1 por cada 10 min.
- Los US$2 de créditos son compartidos: Inference Providers, Endpoints, Spaces de pago, ZeroGPU extra y Jobs.
- Al acabar los créditos hay que comprar más; no basta con activar el pago por uso.
- Resolución, formato vertical y fps de un proveedor van en extra_body; sin eso Wan sale 16:9 a 720p.
- Tres endpoints que Hugging Face lista como activos ya no existen en fal: CogVideoX-5b, Mochi 1 y Wan 2.1 1.3B.