密钥注入

密钥注入 API 用于管理平台侧保存的 HTTPS 请求注入规则。创建沙箱时可以通过 injections 引用已保存规则，或直接传入内联规则。真实密钥由平台侧持有，沙箱内进程不会直接读取真实密钥。

支持的注入类型

所有注入类型都支持 base_url 的 host 精确匹配；当 base_url 包含 path 时按规范化路径精确匹配，path 末尾的 * 表示前缀匹配。http、openai、anthropic、gemini、qiniu 和 github 类型还支持 if_headers / if_queries 条件匹配，用于要求请求中已经存在指定 Header 或 query 参数后才注入。

查询注入规则列表

描述

查询当前账号下已保存的注入规则。

请求路径

GET /injection-rules

响应字段

返回注入规则数组：

请求示例

curl -X GET "$QINIU_SANDBOX_API_URL/injection-rules" \
  -H "Authorization: Qiniu <SignedToken>"

SignedToken 由七牛 AK/SK 对请求签名生成。Go SDK 和 qshell 会自动完成签名。

创建注入规则

描述

创建一条可复用的注入规则。

请求路径

POST /injection-rules

请求参数

http 类型参数：

AI 服务类型参数：

GitHub 类型参数：

响应字段

字段同注入规则列表中的单个规则对象。

请求示例

curl -X POST "$QINIU_SANDBOX_API_URL/injection-rules" \
  -H "Authorization: Qiniu <SignedToken>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "openai-prod",
    "injection": {
      "type": "openai",
      "api_key": "sk-xxx"
    }
  }'

创建带条件匹配的 HTTP 注入规则：

curl -X POST "$QINIU_SANDBOX_API_URL/injection-rules" \
  -H "Authorization: Qiniu <SignedToken>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "internal-api-prod",
    "injection": {
      "type": "http",
      "base_url": "https://api.example.com/v1/*",
      "if_headers": {
        "X-Scope": "prod"
      },
      "if_queries": {
        "inject": "true"
      },
      "headers": {
        "Authorization": "Bearer secret-token"
      }
    }
  }'

创建 GitHub 凭证注入规则：

curl -X POST "$QINIU_SANDBOX_API_URL/injection-rules" \
  -H "Authorization: Qiniu <SignedToken>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "github-api",
    "injection": {
      "type": "github",
      "base_url": "https://api.github.com/repos/qiniu/*",
      "token": "ghp_xxx"
    }
  }'

响应示例

{
  "ruleID": "ir_123456",
  "name": "openai-prod",
  "createdAt": "2026-01-01T00:00:00Z",
  "updatedAt": "2026-01-01T00:00:00Z",
  "injection": {
    "type": "openai"
  }
}

获取注入规则详情

请求路径

GET /injection-rules/{ruleID}

路径参数

成功时返回单个注入规则对象。

更新注入规则

请求路径

PUT /injection-rules/{ruleID}

请求参数

成功时返回更新后的注入规则对象。

删除注入规则

请求路径

DELETE /injection-rules/{ruleID}

成功时返回 204 No Content。

在创建沙箱时引用规则

已保存的注入规则可以在创建沙箱时通过 type: id 引用：

curl -X POST "$QINIU_SANDBOX_API_URL/sandboxes" \
  -H "X-API-Key: $QINIU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "templateID": "base",
    "injections": [
      {
        "type": "id",
        "id": "ir_123456"
      }
    ]
  }'

在创建沙箱时使用内联注入

创建沙箱时也可以直接传入内联注入配置，字段结构与保存的 injection 相同；引用已有规则时使用 type: id。

curl -X POST "$QINIU_SANDBOX_API_URL/sandboxes" \
  -H "X-API-Key: $QINIU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "templateID": "base",
    "injections": [
      {
        "type": "openai",
        "api_key": "sk-xxx"
      },
      {
        "type": "github",
        "base_url": "https://api.github.com/repos/qiniu/*",
        "token": "ghp_xxx"
      }
    ]
  }'

相关文档

• API 概述
• 密钥注入
• 使用 qshell 管理密钥注入