Testador da API Hugging Face para montar, rodar e copiar requisições da Inference API como cURL, Python e JavaScript.
Testador da API Hugging Face
Testador da API Hugging Face para montar, rodar e copiar requisições da Inference API como cURL, Python e 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.
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 Testador de API do Hugging Face
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 da Hugging Face 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
Testador de API da OpenAI — Crie, execute e copie requisições à API Chat Completions da OpenAI como cURL, Python e JavaScript.