什么是 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 限制的终端或服务器中运行良好。

我可以测试哪些模型？

任何暴露了无服务器 Inference API 的模型。工具会建议 Mistral-7B-Instruct、Meta-Llama-3-8B-Instruct 和 gpt2，但你可以输入任何形如 owner/name 的模型 id。

在这里使用我的令牌安全吗？

请求和所有代码都在你的浏览器本地构建。当你点击运行时，调用会从浏览器直接发送给 Hugging Face，而非 ArrayKit，你的令牌仅保留在浏览器内存中——绝不会被存储或发送给 ArrayKit。请避免在共享机器上使用生产环境令牌。

我可以为我的应用生成代码吗？

可以。工具会为你构建的确切请求输出可直接粘贴的 cURL、Python（requests）和 JavaScript（fetch），让你能直接放入脚本或后端。

Hugging Face API Tester

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

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

试用 API 请求客户端

关于 Hugging Face API Tester

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 Tester

输入一个模型 id，例如 mistralai/Mistral-7B-Instruct-v0.2
在输入字段中输入你的内容（例如一段提示词）
将你的 Hugging Face 令牌（hf_…）粘贴到令牌字段中
点击运行以发送请求，或复制 cURL、Python 或 JavaScript 代码
读取 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 限制的终端或服务器中运行良好。
我可以测试哪些模型？: 任何暴露了无服务器 Inference API 的模型。工具会建议 Mistral-7B-Instruct、Meta-Llama-3-8B-Instruct 和 gpt2，但你可以输入任何形如 owner/name 的模型 id。
在这里使用我的令牌安全吗？: 请求和所有代码都在你的浏览器本地构建。当你点击运行时，调用会从浏览器直接发送给 Hugging Face，而非 ArrayKit，你的令牌仅保留在浏览器内存中——绝不会被存储或发送给 ArrayKit。请避免在共享机器上使用生产环境令牌。
我可以为我的应用生成代码吗？: 可以。工具会为你构建的确切请求输出可直接粘贴的 cURL、Python（requests）和 JavaScript（fetch），让你能直接放入脚本或后端。