使用 pip 安装 Taotoken 官方 Python SDK 并快速调用大模型 API

1. 安装 Taotoken Python SDK

Taotoken 提供了兼容 OpenAI 的 Python SDK，可通过 pip 直接安装。在终端或命令行中执行以下命令：

pip install taotoken

安装完成后，可通过 pip show taotoken 验证版本信息。建议使用 Python 3.7 或更高版本运行环境。

2. 获取 API Key 与模型 ID

在开始调用前，需要准备以下两项信息：

1. API Key：登录 Taotoken 控制台，在「API 密钥」页面创建新密钥并复制保存。
2. 模型 ID：进入「模型广场」查看可用模型，如 claude-sonnet-4-6 或 gpt-4-turbo-preview 等，记录需要调用的模型名称。

注意：API Key 应妥善保管，避免泄露或提交到版本控制系统。

3. 配置 SDK 并调用聊天补全 API

以下是一个完整的 Python 示例，展示如何初始化客户端并发送聊天补全请求：

from openai import OpenAI

# 初始化客户端
client = OpenAI(
    api_key="YOUR_API_KEY",  # 替换为你的 Taotoken API Key
    base_url="https://taotoken.net/api",  # Taotoken 聚合端点
)

# 发送请求并打印响应
completion = client.chat.completions.create(
    model="claude-sonnet-4-6",  # 替换为实际模型 ID
    messages=[{"role": "user", "content": "请用中文回答：Python 如何安装第三方库？"}],
)
print(completion.choices[0].message.content)

关键参数说明：

• base_url 必须设置为 https://taotoken.net/api，SDK 会自动补全后续路径
• model 参数需使用 Taotoken 模型广场中列出的完整模型 ID
• messages 遵循 OpenAI 格式，支持多轮对话上下文

4. 处理响应与错误

成功调用后，响应对象包含以下常用字段：

print(completion.id)  # 本次调用的唯一标识
print(completion.usage)  # 输入输出 token 统计
print(completion.choices[0].message.content)  # 模型生成内容

若调用出错（如密钥无效或模型不存在），SDK 会抛出 openai.APIError 异常。建议添加错误处理：

try:
    completion = client.chat.completions.create(...)
except Exception as e:
    print(f"API 调用失败: {e}")

5. 进阶配置与建议

对于生产环境，推荐通过环境变量管理敏感信息：

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.getenv("TAOTOKEN_API_KEY"),  # 从环境变量读取
    base_url="https://taotoken.net/api",
)

其他实用功能可通过相同客户端访问，如嵌入向量生成：

embedding = client.embeddings.create(
    model="text-embedding-3-small",
    input="需要转换为向量的文本",
)

如需进一步了解可用模型与 API 参数，可参考 Taotoken 官方文档中的 API 参考部分。