需先完成实名认证获取appid和api key，再安装requests与python-dotenv库，通过.env文件安全配置凭证，构造含authorization和x-tg-app-id头的post请求调用https://api.tiangong.cn/v2/chat/completions接口。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要在本地Python环境中调用天工AI API，你得先拿到合法凭证、构造合规请求、处理返回结果——缺一不可，否则会直接返回401或403错误。

注册账号并获取API Key

打开天工AI开放平台官网（tiangong.cn），点击右上角“开发者中心”进入注册页面。

使用手机号或邮箱完成实名注册，提交后需等待人工审核，通常在2小时内通过；【未完成实名认证的账号无法创建有效API Key】。

审核通过后，登录控制台 → 左侧菜单栏点击“API密钥管理” → 点击“创建新密钥”，填写应用名称（如“本地测试”）并提交。

页面立即生成一对 credentials：AppID 和 API Key。请复制并安全保存，【API Key仅显示一次，刷新页面即不可见】。

安装必要依赖库

确保已安装 Python 3.8 或更高版本，推荐使用虚拟环境隔离依赖：

python -m venv tiangong_env && tiangong_env\Scripts\activate（Windows）

执行以下命令安装核心库：

pip install requests python-dotenv

requests 用于发起 HTTP 请求；python-dotenv 用于安全加载 .env 文件中的密钥，避免硬编码泄露。

配置环境变量与基础请求

在项目根目录新建 .env 文件，写入：

Claw Code Suite (Python-Only Edition)

仅使用 Python 将 Claw Code 虚拟化框架与 OpenClaw 集成，提供 184 种工具和 200 多条命令，用于安全分析和代码质量...

下载

TG_APP_ID=your_app_id_here
TG_API_KEY=your_api_key_here

新建 main.py，开头添加：

from dotenv import load_dotenv
import os, requests
load_dotenv()

构造请求头时必须包含 Authorization 字段，格式为 Bearer {API_Key}，且需同时传入 AppID 作为 X-TG-App-ID 请求头：

headers = {
  "Authorization": f"Bearer {os.getenv('TG_API_KEY')}",
  "X-TG-App-ID": os.getenv("TG_APP_ID"),
  "Content-Type": "application/json"
}

发送首个文本生成请求

天工AI当前主流模型端点为 https://api.tiangong.cn/v2/chat/completions，仅支持 POST 方法。

准备请求体，注意 model 字段必须为官方支持的值（如 qwen-max 或 qwen-plus），不填或填错将返回 400 错误：

data = {
  "model": "qwen-plus",
  "messages": [{"role": "user", "content": "你好，请用中文简单介绍你自己"}]
}

发起请求并检查状态码：

response = requests.post("https://api.tiangong.cn/v2/chat/completions", headers=headers, json=data, timeout=30)

若 response.status_code == 200，则用 response.json()["choices"][0]["message"]["content"] 提取回复文本；若为 429，说明当前配额已用尽，需等重置或升级套餐。

大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！