欢迎使用
创建 API Key
- 登录 Turing Portal
- 右上角点击头像选择 API Key 管理
- 在 API Key 管理页面,点击创建 API Key
- 复制创建的 API Key(注意保存,后续无法查看)
- 开始构建你的 AI 应用
扩容申请
- 登录 Turing Portal
- 右上角点击头像选择 API Key 管理
- 在 用量管理 界面,点击申请扩容
环境配置
在开始使用 SDK 之前,您需要配置必要的环境变量。我们建议采用以下最佳实践来管理您的配置:
安全提示
请勿将 API Key 直接硬编码在代码中。这可能导致:
- 敏感信息泄露的安全风险
- 不同环境切换时的维护困难
建议使用环境变量或配置系统来管理您的 API Key。
API 节点地址
图灵平台提供多个节点,请根据您的业务需求选择合适的节点:
中国区(默认)
TURING_API_BASE=https://live-turing.cn.llm.tcljd.com/api/v1
欧洲区
TURING_API_BASE=https://live-turing.eu.llm.tcljd.com/api/v1
北美区
TURING_API_BASE=https://live-turing.us.llm.tcljd.com/api/v1
亚太(新加坡)区
TURING_API_BASE=https://live-turing.sg.llm.tcljd.com/api/v1
其他区域
- 其他区域暂未支持,如需使用请联系平台人员
本地开发配置
推荐使用 .env 文件管理环境变量:
# .env 示例(中国区)
TURING_API_BASE=https://live-turing.cn.llm.tcljd.com/api/v1
TURING_API_KEY=your-api-key
最佳实践:
- 将
.env文件添加到.gitignore中,避免敏感信息提交到代码仓库 - 在团队中使用
.env.example作为环境变量模板 - 不同环境(开发、测试、生产)使用不同的
.env文件
Python 环境配置
对于 Python 项目,您可以使用 python-dotenv 包来自动加载 .env 文件:
pip install python-dotenv
from dotenv import load_dotenv
import os
# 加载 .env 文件中的环境变量
load_dotenv()
# 现在可以通过 os.getenv 获取环境变量
api_key = os.getenv("TURING_API_KEY")
api_base = os.getenv("TURING_API_BASE")
Docker 环境配置
在 Docker 环境中,您可以通过以下方式管理环境变量:
- 使用
docker run命令行参数:
docker run -e TURING_API_KEY=your-api-key -e TURING_API_BASE=https://live-turing.cn.llm.tcljd.com/api/v1 your-image
- 使用环境变量文件:
docker run --env-file .env your-image
Docker Compose 配置
推荐的项目结构:
your-project/
├── .env # 本地开发环境变量(不提交到git)
├── .env.example # 环境变量示例(提交到git)
├── docker-compose.yml # 开发环境配置
├── docker-compose.prod.yml # 生产环境配置
└── Dockerfile
开发环境配置示例 (docker-compose.yml):
version: "3.8"
services:
app:
build: .
env_file:
- .env
environment:
- NODE_ENV=development
volumes:
- .:/app
- /app/node_modules
ports:
- "3000:3000"
生产环境配置示例 (docker-compose.prod.yml):
version: "3.8"
services:
app:
image: your-registry/your-image:latest
env_file:
- .env.prod
environment:
- NODE_ENV=production
deploy:
replicas: 3
restart_policy:
condition: any
secrets:
- turing_api_key
secrets:
turing_api_key:
external: true
使用方法:
# 开发环境
docker compose up
# 生产环境
docker compose -f docker-compose.yml -f docker-compose.prod.yml up
生产环境配置
在生产环境中,建议:
- 使用环境变量管理系统(如 Kubernetes Secrets、AWS Secret Manager、Nacos 等)
- 为不同的应用场景使用不同的 API Key,便于管理和控制
选择合适的 SDK 或者 API 调用 并完成配置后,您就可以开始探索使用图灵大模型服务了。