跳转到主要内容

​
身份验证

使用工作区 API 密钥对公开的 Fetch Hive API 请求进行身份验证。

​
身份验证请求头

在每个请求的 Authorization 请求头中发送你的 API 密钥： 
Authorization: Bearer YOUR_API_KEY
Fetch Hive 对公开的 invoke 接口和公开的资源接口使用相同的 bearer 请求头。

​
如何创建 API 密钥？

打开 Settings，然后点击 API Keys。 如果你的工作区还没有默认密钥，点击 Create Default Key。 如果你想为特定服务或环境创建另一个密钥，点击 Add API Key。 选择你想使用的环境：
  • Production
  • Staging
  • Development
当 Fetch Hive 显示 Your New API Key 时复制完整密钥。在对话框关闭后，Fetch Hive 通常只显示密钥前缀。

​
示例请求

curl 'https://api.fetchhive.com/v1/prompt/invoke' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  --data-raw '{
    "deployment": "YOUR_DEPLOYMENT_NAME",
    "variant": "YOUR_VARIANT_NAME",
    "inputs": {
      "text": "Fetch Hive helps teams ship AI products faster."
    },
    "streaming": true
  }' \
  --compressed

​
身份验证失败时会发生什么？

如果 API 密钥缺失、无效或已被吊销，Fetch Hive 会返回错误响应。 
{
  "error": "Invalid access."
}
有关常见状态码和错误结构，请参阅错误和速率限制。有关控制台中的 API 密钥管理，请参阅 API keys。