操作使用

BladeX大约 6 分钟secretops

操作说明

本文档详细介绍超级密钥模块的具体操作步骤，包括密钥的创建、编辑、删除和使用等核心功能。请按照步骤进行操作，确保密钥的安全性和有效性。

一、超级密钥管理总览

登录AI平台，选择【大模型运维】>【超级密钥】，进入超级密钥管理页面。
页面显示所有已创建的超级密钥卡片，包含密钥说明、密钥值、过期时间和状态信息。
可以通过搜索框按密钥名称快速查找特定的密钥。
使用分页组件浏览大量密钥记录。

二、新增超级密钥

在超级密钥管理页面，点击【添加超级密钥】按钮，打开新增密钥表单。

填写密钥基本信息：
- 密钥说明：输入便于识别的密钥说明（必填）
- 过期时间：设置密钥的过期时间（可选，不设置则永久有效）
系统说明：
- 超级密钥将自动生成，格式为sk-xxxxxxxxxxxxxxxxxxxxxxxx
- 密钥创建成功后会自动复制到剪贴板
- 请妥善保存生成的密钥，后续无法查看完整密钥
点击【确定】保存密钥配置。

密钥生成说明

系统会自动生成安全的超级密钥
密钥格式固定为sk-前缀加随机字符串
新创建的密钥会自动复制到剪贴板，方便使用
建议立即将密钥保存到安全的地方

三、编辑超级密钥

在密钥列表中，将鼠标悬停在要编辑的密钥卡片上。
点击出现的【编辑】按钮（铅笔图标），打开编辑表单。

可以修改以下信息：
- 密钥说明：更新密钥的说明文字
- 过期时间：调整密钥的过期时间
注意事项：
- 密钥值本身无法修改，如需更换请创建新密钥
- 修改过期时间会立即生效
- 过期的密钥将无法继续使用
确认修改后点击【确定】保存更新。

编辑注意事项

超级密钥的值无法修改，只能调整说明和过期时间
如需更换密钥值，请创建新密钥并删除旧密钥
修改过期时间后，正在使用该密钥的系统可能受到影响

四、复制超级密钥

在密钥列表中，将鼠标悬停在需要使用的密钥卡片上。
点击出现的【复制密钥】按钮（复制图标）。
密钥值会自动复制到剪贴板。
可以在API调用中直接粘贴使用。

复制功能说明

复制功能会将完整的密钥值复制到剪贴板
建议复制后立即使用，避免剪贴板被其他内容覆盖
如果复制失败，可以手动选择密钥文本进行复制

五、删除超级密钥

在密钥列表中，将鼠标悬停在要删除的密钥卡片上。
点击出现的【删除】按钮（垃圾桶图标）。
系统会弹出确认对话框，点击【确定】完成删除。

删除风险提示

删除操作不可恢复，请谨慎操作
删除前请确认该密钥没有被任何系统正在使用
建议在删除前创建新密钥替换旧密钥
删除后使用该密钥的API调用将立即失效

六、API调用使用

6.1 认证方式

所有API调用都需要在请求头中添加超级密钥：

Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxx
Content-Type: application/json

6.2 大模型对话API

接口地址: POST /v1/chat/completions

请求示例:

curl --request POST \
  --url http://localhost:8060/blade-ai/v1/chat/completions \
  --header 'Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxx' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "Qwen/QwQ-32B",
    "messages": [
      {
        "role": "user",
        "content": "What opportunities and challenges will the Chinese large model industry face in 2025?"
      }
    ],
    "stream": false,
    "max_tokens": 512,
    "temperature": 0.7,
    "top_p": 0.7
  }'

6.3 向量搜索API

接口地址: POST /v1/rag/search

请求示例:

curl --request POST \
  --url "http://localhost:8060/blade-ai/v1/rag/search" \
  --header "Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxx" \
  --header "Content-Type: application/json" \
  --data '{
    "knowledgeIds": [1922944017031983105],
    "text": "知识库相关内容",
    "maxResults": 10,
    "minSimilarity": 0.7
  }'

6.4 工作流执行API

接口地址: POST /v1/flow/execute/{flowId}

请求示例:

curl --request POST \
  --url http://localhost:8060/blade-ai/v1/flow/execute/1921759956666085377 \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxx' \
  --data '{}'