跳到主要内容

欢迎使用

创建 API Key

  1. 登录 Turing Portal
  2. 右上角点击头像选择 API Key 管理
  3. 在 API Key 管理页面,点击创建 API Key
  4. 复制创建的 API Key(注意保存,后续无法查看)
  5. 开始构建你的 AI 应用

扩容申请

  1. 登录 Turing Portal
  2. 右上角点击头像选择 API Key 管理
  3. 在 用量管理 界面,点击申请扩容
信息

Turing 平台集成多种主流模型类型,请在 模型列表 选择适用您业务的模型。第一次调用参考 快速开始

环境配置

在开始使用 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 环境中,您可以通过以下方式管理环境变量:

  1. 使用 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
  1. 使用环境变量文件:
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 调用 并完成配置后,您就可以开始探索使用图灵大模型服务了。

下一步