Hugging Face API 测试器

Hugging Face API 测试器,用于构建、运行并以 cURL、Python 和 JavaScript 形式复制 Inference API 请求。

构建请求以及 cURL、Python 和 JavaScript 代码的过程完全在你的浏览器中完成。当你点击运行时,你的 Hugging Face 令牌和输入会从浏览器直接发送给 Hugging Face Inference API——绝不发送给 ArrayKit。你的令牌仅保留在浏览器内存中,绝不会被存储或发送给 ArrayKit。请避免在共享或公共机器上使用生产环境令牌。

由 Udit Agarwal 开发和维护

试用 API 请求客户端

关于 Hugging Face API 测试工具

Hugging Face API 测试器让你无需离开浏览器即可构建、运行并复制 Hugging Face Inference API 请求。输入一个模型 id,如 mistralai/Mistral-7B-Instruct-v0.2,输入你的内容,粘贴你的 hf_ 令牌,ArrayKit 便会组装发送到 https://api-inference.huggingface.co/models/{model} 的 POST 请求,带上正确的 Authorization: Bearer 请求头和 JSON 请求体。它会即时生成可直接粘贴的 cURL、Python(requests)和 JavaScript(fetch)代码片段,在 Hugging Face 允许跨域调用的情况下,你可以点击运行查看实时响应。它专为想要快速冒烟测试模型、确认令牌可用或为应用获取干净代码的机器学习工程师、后端开发者和提示词爱好者而设计。请求和所有代码都在你的浏览器本地构建;当你运行时,调用会从浏览器直接发送给 Hugging Face。

功能特性

  • 根据模型 id 和输入构建 Hugging Face Inference API 请求
  • 生成发送到 /models/{model} 的正确 POST 请求,带 Authorization: Bearer hf_ 请求头
  • 复制可直接运行的 cURL、Python(requests)和 JavaScript(fetch)代码片段
  • 当 Hugging Face 允许跨域调用时,在浏览器中运行请求
  • 提供模型建议,如 Mistral-7B-Instruct、Meta-Llama-3-8B-Instruct 和 gpt2
  • 发送 Inference API 期望的标准 { "inputs": ... } JSON 请求体
  • 令牌仅保留在浏览器内存中——绝不会被存储或发送给 ArrayKit
  • 查看 Hugging Face 返回的原始 JSON 响应和 HTTP 状态

如何使用 Hugging Face API 测试工具

  1. 输入一个模型 id,例如 mistralai/Mistral-7B-Instruct-v0.2
  2. 在输入字段中输入你的内容(例如一段提示词)
  3. 将你的 Hugging Face 令牌(hf_…)粘贴到令牌字段中
  4. 点击运行以发送请求,或复制 cURL、Python 或 JavaScript 代码
  5. 读取 JSON 响应和状态,然后调整模型或输入并重试

示例

输入

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

输出

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

一个最简的 Hugging Face Inference API 调用,带有 hf_ 令牌和 JSON 输入。

常见错误与故障排除

  • 浏览器运行因 CORS 错误失败。 — Hugging Face Inference API 经常阻止跨域浏览器调用。请复制生成的 cURL 或 Python 代码片段,从终端或你的服务器运行。
  • 401 Unauthorized 或 Invalid credentials(凭据无效)。 — 检查你的令牌是否以 hf_ 开头并完整粘贴、没有空格。可从 huggingface.co/settings/tokens 创建或复制一个有效令牌。
  • 503,附带 estimated_time 消息。 — 模型正在加载(冷启动)。请等待估计的秒数后重试,或再次发送请求——无服务器模型会在首次调用时预热。
  • 404 Model not found(未找到模型)。 — 确认模型 id 与仓库路径完全一致(owner/name,区分大小写),例如 mistralai/Mistral-7B-Instruct-v0.2,且该模型已暴露 Inference API。
  • 意外的响应结构或任务错误。 — 不同的模型任务期望不同的输入。对于文本生成,请在 "inputs" 中发送一个字符串;请在 Hugging Face 上查看模型卡片以确认确切的输入格式。

常见问题

什么是 Hugging Face API 测试器?
它是一款 ArrayKit 工具,可根据模型 id、输入和你的 hf_ 令牌构建 Hugging Face Inference API 请求,然后让你运行它们并复制等效的 cURL、Python 和 JavaScript 代码。
我需要 Hugging Face 令牌吗?
需要。Inference API 调用使用 Authorization: Bearer hf_ 令牌。请在 huggingface.co/settings/tokens 生成一个并粘贴到令牌字段中。
为什么在浏览器中运行会失败,而 cURL 却能用?
Hugging Face Inference API 通常不会为浏览器请求发送 CORS 请求头。生成的 cURL 或 Python 代码片段在不受 CORS 限制的终端或服务器中运行良好。
我可以测试哪些 Hugging Face 模型?
任何暴露了无服务器 Inference API 的模型。工具会建议 Mistral-7B-Instruct、Meta-Llama-3-8B-Instruct 和 gpt2,但你可以输入任何形如 owner/name 的模型 id。
在这里使用我的令牌安全吗?
请求和所有代码都在你的浏览器本地构建。当你点击运行时,调用会从浏览器直接发送给 Hugging Face,而非 ArrayKit,你的令牌仅保留在浏览器内存中——绝不会被存储或发送给 ArrayKit。请避免在共享机器上使用生产环境令牌。
我可以为我的应用生成代码吗?
可以。工具会为你构建的确切请求输出可直接粘贴的 cURL、Python(requests)和 JavaScript(fetch),让你能直接放入脚本或后端。

相关工具

  • OpenAI API 测试工具 — 构建、运行并复制 OpenAI Chat Completions API 请求,支持 cURL、Python 和 JavaScript。
  • Anthropic Claude API 测试工具 — 构建、运行并复制 Anthropic Claude Messages API 请求,支持 cURL、Python 和 JavaScript。
  • Google Gemini API 测试工具 — 构建、运行并复制 Google Gemini generateContent API 请求,支持 cURL、Python 和 JavaScript。
  • Replicate API 测试工具 — 构建、运行并复制 Replicate 预测 API 请求,支持 cURL、Python 和 JavaScript。
  • API 客户端 — 发送 HTTP 请求,构建头部和参数并查看响应;保存最近 25 条记录。
  • cURL 转 Fetch — 将 curl 命令转换为 JavaScript 的 fetch() 调用。
  • Basic Auth 生成器 — 根据用户名和密码生成并解码 HTTP Basic Auth 授权头。
  • URL 解析器 — 将 URL 拆解为各个部分并列出查询参数。

更多API 工具工具

  • curl 转 Python — 将 curl 命令转换为可运行的 Python requests 代码。
  • curl 转 Go — 将 curl 命令转换为可运行的 Go net/http 代码。
  • curl 转 PHP — 将 curl 命令转换为地道的 PHP cURL 代码。
  • curl 转 Node.js — 将 curl 命令转换为 Node.js axios 请求代码。
  • Token 计数器 — 为 GPT、Claude 和 Gemini 计数 token,在你键入时实时更新。
  • LLM 成本计算器 — 根据 token 数估算 GPT、Claude 和 Gemini 的 API 成本。
  • cURL 转 Rust — 将 curl 命令转换为 Rust reqwest 代码。
  • HAR转cURL — 把HAR中的请求转换为可运行的cURL命令。
  • Postman转cURL工具 — 把Postman集合转换成可运行的cURL命令。
  • cURL 转 C# — 把 curl 命令转成使用 HttpClient 的 C# 代码。
  • cURL 转 Java — 把 curl 命令转成使用 HttpClient 的 Java 代码。
  • cURL 转 Ruby — 把 curl 命令转成使用 Net::HTTP 的 Ruby 代码。

查看全部API 工具工具 (24) · 全部工具