准备工作与认证配置
调用百炼API前需完成以下步骤:
初始化SDK与参数设置
在Python脚本中导入依赖并配置基础参数:
from http import HTTPStatus
import dashscope
# 设置API终端节点(公网/私网)
dashscope.base_http_api_url = 'https://dashscope.aliyuncs.com/api/v1' #
dashscope.api_key = os.getenv("DASHSCOPE_API_KEY")
需指定app_id
参数标识目标应用,可通过控制台应用卡片获取该ID
调用逻辑与代码实现
基础单轮对话调用示例:
response = application.call(
app_id='YOUR_APP_ID',
prompt='如何制作番茄炒蛋?'
if response.status_code == HTTPStatus.OK:
print(response.output.text) #
支持通过messages
参数实现多轮对话:
- 使用
role:user
和role:assistant
区分对话角色 - 通过
session_id
维护对话上下文
高级功能与错误处理
可通过以下参数实现增强功能:
参数 | 功能说明 |
---|---|
stream=True | 启用流式输出 |
result_format=’message’ | 结构化响应格式 |
seed=random_int | 控制输出随机性 |
错误处理应包含状态码检查:
if response.status_code != HTTPStatus.OK:
print(f'错误代码:{response.code} 请求ID:{response.request_id}') #