鉴权认证

鉴权介绍

鉴权的主要目的是用于校验调用者的身份信息。调用千帆ModelBuilder平台功能OpenAPI需使用基于安全认证AK/SK进行签名计算鉴权。

• 基于安全认证AK/SK进行签名计算鉴权

使用安全认证中的Access Key（即AK）和Secret Key（即SK）进行签名计算，将HTTP请求发送到百度智能云时，需要对请求进行签名计算，以便百度智能云可以识别身份。

如何获取安全认证AK/SK

鉴权需要获取 Access Key(即AK)和Secret Key(即SK)，用于 API 请求认证和鉴权，如何获取可参考获取AK/SK文档。

HTTP调用API鉴权说明

使用HTTP调用API时，需对请求进行签名，在请求时将签名信息添加到消息头，进行身份认证。

• 签名计算等具体鉴权认证机制，请参考鉴权认证机制。
• 如何使用安全认证AK和SK鉴权调用API，请参考基于安全认证AK/SK鉴权调用API流程。

SDK调用API鉴权说明

通过SDK调用API时，SDK会获取安全认证AK和SK初始化信息，并自动完成鉴权相关步骤。

Python SDK

支持通过参数、内置函数初始化、环境变量三种初始化方式，优先级由低到高为：环境变量初始化<内置函数初始化<参数初始化。

推荐使用环境变量方式初始化，示例如下，其他方式请查看https://github.com/baidubce/bce-qianfan-sdk/blob/main/python/README.pypi.md。

# 通过环境变量传递（作用于全局，优先级最低）
import os

# 替换下列示例中参数，安全认证Access Key替换your_access_key，Secret Key替换your_secret_key
os.environ["QIANFAN_ACCESS_KEY"] = "your_access_key"
os.environ["QIANFAN_SECRET_KEY"] = "your_secret_key"

Go SDK

支持通过环境变量、参数设置两种初始化方式。

推荐使用环境变量初始化，示例如下，其他方式请查看https://github.com/baidubce/bce-qianfan-sdk/tree/main/go。

// 通过环境变量初始化
import (
    "os"
)

// 替换下列示例中参数，安全认证Access Key替换your_access_key，Secret Key替换your_secret_key
os.Setenv("QIANFAN_ACCESS_KEY", "your_access_key")
os.Setenv("QIANFAN_SECRET_KEY", "your_secret_key")

Java SDK

支持通过参数初始化、环境变量初始化，环境变量初始化方式如下，其他方式请查看https://github.com/baidubce/bce-qianfan-sdk/tree/main/java。

export QIANFAN_ACCESS_KEY=your_access_key
export QIANFAN_SECRET_KEY=your_secret_key

Node.js SDK

支持通过配置文件、环境变量、参数三种初始化方式。

推荐使用环境变量方式初始化，示例如下。其他初始化方式可以参考https://github.com/baidubce/bce-qianfan-sdk/tree/main/javascript。

import {setEnvVariable} from "@baiducloud/qianfan";

// 环境变量初始化
// 替换下列示例中参数，安全认证Access Key替换your_access_key，Secret Key替换your_secret_key
setEnvVariable('QIANFAN_ACCESS_KEY','your_access_key');
setEnvVariable('QIANFAN_SECRET_KEY','your_secret_key');

SDK调用API流程说明

• Python SDK，请查看Python SDK安装及使用流程
• Go SDK，请查看Go SDK安装及使用流程
• Java SDK，请查看Java SDK安装及使用流程
• Node.js SDK，请查看Node.js SDK安装及使用流程