Hugging Face API Tester
Build, run and copy Hugging Face Inference API requests as cURL, Python and JavaScript.
La construcción de la solicitud y del código cURL, Python y JavaScript ocurre por completo en tu navegador. Cuando pulsas Ejecutar, tu token de Hugging Face y tus entradas se envían directamente desde tu navegador a la Inference API de Hugging Face, nunca a ArrayKit. Tu token se mantiene solo en la memoria del navegador y nunca se almacena ni se envía a ArrayKit. Evita usar tokens de producción en máquinas compartidas o públicas.
Prueba el Cliente de Solicitudes de API
Acerca de Hugging Face API Tester
El probador de API de Hugging Face te permite construir, ejecutar y copiar solicitudes de la Inference API de Hugging Face sin salir de tu navegador. Introduce un id de modelo como mistralai/Mistral-7B-Instruct-v0.2, escribe tus entradas, pega tu token hf_, y ArrayKit arma el POST a https://api-inference.huggingface.co/models/{model} con la cabecera Authorization: Bearer correcta y el cuerpo JSON. Genera al instante fragmentos listos para pegar en cURL, Python (requests) y JavaScript (fetch), y donde Hugging Face permita llamadas de origen cruzado puedes pulsar Ejecutar para ver la respuesta en vivo. Está pensado para ingenieros de ML, desarrolladores backend y aficionados a los prompts que quieren hacer una prueba rápida de un modelo, confirmar que un token funciona o conseguir código limpio para una aplicación. La solicitud y todo el código se construyen localmente en tu navegador; cuando pulsas Ejecutar, la llamada va directamente desde tu navegador a Hugging Face.
Características
- Construye solicitudes de la Inference API de Hugging Face a partir de un id de modelo y entradas
- Genera el POST correcto a /models/{model} con la cabecera Authorization: Bearer hf_
- Copia fragmentos listos para ejecutar en cURL, Python (requests) y JavaScript (fetch)
- Ejecuta la solicitud en el navegador cuando Hugging Face permite la llamada de origen cruzado
- Sugerencias de modelos como Mistral-7B-Instruct, Meta-Llama-3-8B-Instruct y gpt2
- Envía el cuerpo JSON estándar { "inputs": ... } que espera la Inference API
- El token se mantiene solo en la memoria del navegador: nunca se almacena ni se envía a ArrayKit
- Inspecciona la respuesta JSON sin procesar y el estado HTTP que devuelve Hugging Face
Cómo usar Hugging Face API Tester
- Introduce un id de modelo como mistralai/Mistral-7B-Instruct-v0.2
- Escribe tus entradas (por ejemplo, un prompt) en el campo Inputs
- Pega tu token de Hugging Face (hf_…) en el campo del token
- Pulsa Ejecutar para enviar la solicitud, o copia el código cURL, Python o JavaScript
- Lee la respuesta JSON y el estado, luego ajusta el modelo o las entradas y vuelve a intentarlo
Ejemplo
Entrada
curl -X POST 'https://api-inference.huggingface.co/models/mistralai/Mistral-7B-Instruct-v0.2' \
-H 'Authorization: Bearer hf_xxx' \
-H 'Content-Type: application/json' \
-d '{"inputs":"Write a haiku about TypeScript."}'
Salida
[{"generated_text":"Types guard every line..."}]
Una llamada mínima a la Inference API de Hugging Face con un token hf_ y entradas JSON.
Errores comunes y solución de problemas
- La ejecución en el navegador falla con un error de CORS. — La Inference API de Hugging Face a menudo bloquea las llamadas de origen cruzado desde el navegador. Copia el cURL o el fragmento de Python generado y ejecútalo desde una terminal o tu servidor.
- 401 Unauthorized o credenciales no válidas. — Comprueba que tu token empieza por hf_ y está pegado completo, sin espacios. Crea o copia un token válido desde huggingface.co/settings/tokens.
- 503 con un mensaje estimated_time. — El modelo se está cargando (arranque en frío). Espera los segundos estimados y reintenta, o vuelve a enviar la solicitud; los modelos sin servidor se calientan en la primera llamada.
- 404 Model not found. — Verifica que el id del modelo coincida exactamente con la ruta del repositorio (owner/name, sensible a mayúsculas), p. ej. mistralai/Mistral-7B-Instruct-v0.2, y que el modelo exponga la Inference API.
- Forma de respuesta inesperada o error de tarea. — Distintas tareas de modelo esperan entradas distintas. Para generación de texto envía una cadena en "inputs"; consulta la ficha del modelo en Hugging Face para el formato de entrada exacto.
Preguntas frecuentes
- ¿Qué es el probador de API de Hugging Face?
- Es una herramienta de ArrayKit que construye solicitudes de la Inference API de Hugging Face a partir de un id de modelo, entradas y tu token hf_, luego te deja ejecutarlas y copiar el código equivalente en cURL, Python y JavaScript.
- ¿Necesito un token de Hugging Face?
- Sí. Las llamadas a la Inference API usan un token Authorization: Bearer hf_. Genera uno en huggingface.co/settings/tokens y pégalo en el campo del token.
- ¿Por qué falla Ejecutar en el navegador cuando el cURL funciona?
- La Inference API de Hugging Face con frecuencia no envía cabeceras CORS para las solicitudes del navegador. El cURL o el fragmento de Python generado funciona sin problemas desde una terminal o servidor, donde CORS no aplica.
- ¿Qué modelos puedo probar?
- Cualquier modelo que exponga la Inference API sin servidor. La herramienta sugiere Mistral-7B-Instruct, Meta-Llama-3-8B-Instruct y gpt2, pero puedes escribir cualquier id de modelo como owner/name.
- ¿Es seguro usar aquí mi token?
- La solicitud y todo el código se construyen localmente en tu navegador. Cuando pulsas Ejecutar, la llamada va directamente desde tu navegador a Hugging Face, no a ArrayKit, y tu token se mantiene solo en la memoria del navegador: nunca se almacena ni se envía a ArrayKit. Evita usar tokens de producción en máquinas compartidas.
- ¿Puedo generar código para mi aplicación?
- Sí. La herramienta produce cURL, Python (requests) y JavaScript (fetch) listos para pegar para la solicitud exacta que construiste, así que puedes llevarlos directamente a un script o backend.
Herramientas relacionadas
- OpenAI API Tester — Build, run and copy OpenAI Chat Completions API requests as cURL, Python and JavaScript.
- Anthropic Claude API Tester — Build, run and copy Anthropic Claude Messages API requests as cURL, Python and JavaScript.
- Google Gemini API Tester — Build, run and copy Google Gemini generateContent API requests as cURL, Python and JavaScript.
- Replicate API Tester — Build, run and copy Replicate prediction API requests as cURL, Python and JavaScript.
- Cliente de API — Envía peticiones HTTP, crea cabeceras y parámetros e inspecciona respuestas; guarda tus últimas 25.
- cURL a Fetch — Convierte un comando curl en una llamada fetch() de JavaScript.
- Basic Auth Generator — Generate and decode HTTP Basic Auth Authorization headers from a username and password.
- Analizador de URL — Descompone una URL en sus partes y lista los parámetros de consulta.
Todas las herramientas de ArrayKit