O que é o Testador da API Hugging Face?

É uma ferramenta da ArrayKit que monta requisições da Inference API da Hugging Face a partir de um id de modelo, inputs e seu token hf_, então permite rodá-las e copiar o código equivalente em cURL, Python e JavaScript.

Preciso de um token da Hugging Face?

Sim. As chamadas à Inference API usam um token Authorization: Bearer hf_. Gere um em huggingface.co/settings/tokens e cole-o no campo do token.

Por que Rodar falha no navegador quando o cURL funciona?

A Inference API da Hugging Face frequentemente não envia cabeçalhos CORS para requisições de navegador. O cURL ou o trecho Python gerado roda sem problemas em um terminal ou servidor, onde o CORS não se aplica.

Quais modelos posso testar?

Qualquer modelo que exponha a Inference API serverless. A ferramenta sugere Mistral-7B-Instruct, Meta-Llama-3-8B-Instruct e gpt2, mas você pode digitar qualquer id de modelo como owner/name.

É seguro usar meu token aqui?

A requisição e todo o código são construídos localmente no seu navegador. Quando você pressiona Rodar, a chamada vai diretamente do seu navegador para a Hugging Face, não para a ArrayKit, e seu token fica apenas na memória do navegador — nunca armazenado ou enviado à ArrayKit. Evite usar tokens de produção em máquinas compartilhadas.

Posso gerar código para o meu aplicativo?

Sim. A ferramenta gera cURL, Python (requests) e JavaScript (fetch) prontos para colar para a exata requisição que você montou, então você pode colocá-lo direto em um script ou backend.

Hugging Face API Tester

Build, run and copy Hugging Face Inference API requests as cURL, Python and JavaScript.

A montagem da requisição e do código cURL, Python e JavaScript acontece inteiramente no seu navegador. Quando você pressiona Rodar, seu token da Hugging Face e seus inputs são enviados diretamente do seu navegador para a Inference API da Hugging Face — nunca para a ArrayKit. Seu token fica apenas na memória do navegador e nunca é armazenado ou enviado à ArrayKit. Evite usar tokens de produção em máquinas compartilhadas ou públicas.

Experimente o Cliente de Requisições de API

Sobre Hugging Face API Tester

O Testador da API Hugging Face permite montar, rodar e copiar requisições da Inference API da Hugging Face sem sair do navegador. Informe um id de modelo como mistralai/Mistral-7B-Instruct-v0.2, digite seus inputs, cole seu token hf_, e a ArrayKit monta o POST para https://api-inference.huggingface.co/models/{model} com o cabeçalho Authorization: Bearer correto e o corpo JSON. Ela gera instantaneamente trechos prontos para colar em cURL, Python (requests) e JavaScript (fetch), e onde a Hugging Face permite chamadas entre origens você pode pressionar Rodar para ver a resposta ao vivo. Foi feito para engenheiros de ML, desenvolvedores de backend e entusiastas de prompt que querem fazer um teste rápido de um modelo, confirmar que um token funciona ou pegar código limpo para um aplicativo. A requisição e todo o código são construídos localmente no seu navegador; quando você Roda, a chamada vai diretamente do seu navegador para a Hugging Face.

Recursos

Monte requisições da Inference API da Hugging Face a partir de um id de modelo e inputs
Gera o POST correto para /models/{model} com o cabeçalho Authorization: Bearer hf_
Copie trechos prontos para rodar em cURL, Python (requests) e JavaScript (fetch)
Rode a requisição no navegador quando a Hugging Face permitir a chamada entre origens
Sugestões de modelos como Mistral-7B-Instruct, Meta-Llama-3-8B-Instruct e gpt2
Envia o corpo JSON padrão { "inputs": ... } que a Inference API espera
O token fica apenas na memória do navegador — nunca armazenado ou enviado à ArrayKit
Inspecione a resposta JSON bruta e o status HTTP retornados pela Hugging Face

Como usar Hugging Face API Tester

Informe um id de modelo como mistralai/Mistral-7B-Instruct-v0.2
Digite seus inputs (por exemplo, um prompt) no campo Inputs
Cole seu token da Hugging Face (hf_…) no campo do token
Pressione Rodar para enviar a requisição, ou copie o código cURL, Python ou JavaScript
Leia a resposta JSON e o status, depois ajuste o modelo ou os inputs e tente novamente

Exemplo

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."}'

Saída

[{"generated_text":"Types guard every line..."}]

Uma chamada mínima à Inference API da Hugging Face com um token hf_ e inputs JSON.

Erros comuns e solução de problemas

O Rodar no navegador falha com um erro de CORS. — A Inference API da Hugging Face costuma bloquear chamadas de navegador entre origens. Copie o cURL ou o trecho Python gerado e rode-o em um terminal ou no seu servidor.
401 Unauthorized ou Invalid credentials. — Verifique se o seu token começa com hf_ e está colado por completo, sem espaços. Crie ou copie um token válido em huggingface.co/settings/tokens.
503 com uma mensagem de estimated_time. — O modelo está carregando (cold start). Aguarde os segundos estimados e tente novamente, ou envie a requisição de novo — modelos serverless aquecem na primeira chamada.
404 Model not found. — Verifique se o id do modelo corresponde exatamente ao caminho do repositório (owner/name, sensível a maiúsculas), por exemplo mistralai/Mistral-7B-Instruct-v0.2, e se o modelo expõe a Inference API.
Formato de resposta inesperado ou um erro de tarefa. — Tarefas de modelos diferentes esperam inputs diferentes. Para geração de texto, envie uma string em "inputs"; confira o card do modelo na Hugging Face para o formato exato de entrada.

Perguntas frequentes

O que é o Testador da API Hugging Face?: É uma ferramenta da ArrayKit que monta requisições da Inference API da Hugging Face a partir de um id de modelo, inputs e seu token hf_, então permite rodá-las e copiar o código equivalente em cURL, Python e JavaScript.
Preciso de um token da Hugging Face?: Sim. As chamadas à Inference API usam um token Authorization: Bearer hf_. Gere um em huggingface.co/settings/tokens e cole-o no campo do token.
Por que Rodar falha no navegador quando o cURL funciona?: A Inference API da Hugging Face frequentemente não envia cabeçalhos CORS para requisições de navegador. O cURL ou o trecho Python gerado roda sem problemas em um terminal ou servidor, onde o CORS não se aplica.
Quais modelos posso testar?: Qualquer modelo que exponha a Inference API serverless. A ferramenta sugere Mistral-7B-Instruct, Meta-Llama-3-8B-Instruct e gpt2, mas você pode digitar qualquer id de modelo como owner/name.
É seguro usar meu token aqui?: A requisição e todo o código são construídos localmente no seu navegador. Quando você pressiona Rodar, a chamada vai diretamente do seu navegador para a Hugging Face, não para a ArrayKit, e seu token fica apenas na memória do navegador — nunca armazenado ou enviado à ArrayKit. Evite usar tokens de produção em máquinas compartilhadas.
Posso gerar código para o meu aplicativo?: Sim. A ferramenta gera cURL, Python (requests) e JavaScript (fetch) prontos para colar para a exata requisição que você montou, então você pode colocá-lo direto em um script ou backend.

Ferramentas 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 — Envie requisições HTTP, monte cabeçalhos e parâmetros e inspecione respostas; salva as últimas 25.
cURL para Fetch — Converta um comando curl em uma chamada fetch() de JavaScript.
Basic Auth Generator — Generate and decode HTTP Basic Auth Authorization headers from a username and password.
Analisador de URL — Decomponha uma URL em suas partes e liste os parâmetros de consulta.