需先安装sdk、配置api密钥、初始化客户端并调用text_analysis接口,否则请求将被拒绝;安装执行pip install tiangong-sdk(需python 3.8+);密钥需在开放平台创建并存入.env文件;支持环境变量自动加载、显式传参或手动提取三种初始化方式;分析时analysis_types必须为列表,如["sentiment", "intent"]。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要在Python代码中通过SDK调用天工AI进行语义分析,需先完成官方SDK安装、API密钥配置、客户端初始化,并调用指定的语义分析接口(如text_analysis),否则请求会因认证失败或参数缺失被拒绝。
安装天工AI Python SDK
打开终端或命令行,执行 pip install tiangong-sdk。注意必须使用 Python 3.8 及以上版本,低版本可能因依赖冲突导致 import 失败。
这一步操作起来很简单,直接把命令复制粘贴运行就行。
获取并配置API密钥
登录天工AI开放平台(https://platform.tiangong.cn),进入「控制台 → API密钥管理」,创建新密钥,复制 【APP_KEY 和 APP_SECRET】。
密钥一旦生成就无法再次查看明文,请立即保存到安全位置;若丢失只能删除重建,旧密钥将立即失效。
在项目根目录下新建 .env 文件,写入:
TIANGONG_APP_KEY=your_app_key_here
TIANGONG_APP_SECRET=your_app_secret_here
初始化客户端并调用语义分析接口
方法一:使用环境变量自动加载
import os
from tiangong import TiangongClient
client = TiangongClient() # 自动读取 .env 中的 APP_KEY 和 APP_SECRET
方法二:显式传入凭证(适合临时调试)
client = TiangongClient(
app_key="your_app_key",
app_secret="your_app_secret"
)
方法三:从环境变量手动提取(便于做密钥校验)
app_key = os.getenv("TIANGONG_APP_KEY")
app_secret = os.getenv("TIANGONG_APP_SECRET")
if not app_key or not app_secret:
raise ValueError("缺少 TIANGONG_APP_KEY 或 TIANGONG_APP_SECRET 环境变量")
client = TiangongClient(app_key, app_secret)
执行语义分析任务
第一步:准备待分析文本
text = "这个产品设计简洁,但操作逻辑不够直观,用户反馈学习成本偏高。"
第二步:调用 text_analysis 方法,指定分析类型为 sentiment(情感)和 intent(意图)
result = client.text_analysis(
text=text,
analysis_types=["sentiment", "intent"]
)
第三步:解析返回结果中的核心字段
print("情感倾向:", result["sentiment"]["label"]) # 输出:negative / neutral / positive
print("主意图:", result["intent"]["label"]) # 输出:complaint / suggestion / praise
注意:analysis_types 参数必须是列表,即使只分析一种类型也要写成 ["sentiment"],传字符串会抛出 TypeError。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!











