使用 pip 安装 Taotoken 官方 Python SDK 并完成首次 API 调用
使用 pip 安装 Taotoken 官方 Python SDK 并完成首次 API 调用
1. 环境准备与 SDK 安装
确保您的 Python 环境版本为 3.7 或更高。通过以下 pip 命令安装 Taotoken 官方推荐的 OpenAI 兼容 SDK:
pip install openai该 SDK 与原生 OpenAI Python SDK 完全兼容,但通过配置不同的base_url可无缝接入 Taotoken 平台。若已安装旧版本,建议使用--upgrade参数更新:
pip install --upgrade openai2. 获取 Taotoken API Key 与模型 ID
登录 Taotoken 控制台,在「API 密钥」页面创建新的密钥。复制生成的密钥字符串(形如sk-xxxxxxxxxx)并妥善保存,该密钥将用于所有 API 请求的身份验证。
在「模型广场」页面查看可用模型列表,选择目标模型并记录其 ID(例如claude-sonnet-4-6)。模型 ID 是发起请求时的必填参数,决定了调用的具体模型版本。
3. 配置 SDK 并发送请求
新建 Python 文件,导入 SDK 并初始化客户端。关键配置项包括:
api_key: 填入上一步获取的 Taotoken API Keybase_url: 固定为https://taotoken.net/api
from openai import OpenAI client = OpenAI( api_key="YOUR_API_KEY", # 替换为实际密钥 base_url="https://taotoken.net/api", ) response = client.chat.completions.create( model="claude-sonnet-4-6", # 替换为目标模型 ID messages=[{"role": "user", "content": "请用中文自我介绍"}], ) print(response.choices[0].message.content)4. 执行与结果验证
运行脚本后,SDK 会将请求发送至 Taotoken 聚合端点,返回结果结构与原生 OpenAI API 一致。成功调用后,控制台将输出模型生成的响应内容。典型成功响应如下所示:
{ "id": "chatcmpl-123", "object": "chat.completion", "created": 1677652288, "model": "claude-sonnet-4-6", "choices": [{ "index": 0, "message": { "role": "assistant", "content": "我是 Claude,一个由 Anthropic 开发的人工智能助手..." }, "finish_reason": "stop" }], "usage": { "prompt_tokens": 9, "completion_tokens": 28, "total_tokens": 37 } }5. 进阶配置与错误处理
为提升可靠性,建议添加超时设置和基础错误处理:
try: response = client.chat.completions.create( model="claude-sonnet-4-6", messages=[{"role": "user", "content": "请用中文自我介绍"}], timeout=10 # 单位:秒 ) print(response.choices[0].message.content) except Exception as e: print(f"API 调用失败: {str(e)}")调用消耗的 Token 数量会在响应体的usage字段返回,可用于成本核算。所有调用记录可在 Taotoken 控制台的「用量统计」页面查看明细。
现在您已完成 Taotoken Python SDK 的基础接入,可前往 Taotoken 探索更多可用模型与高级功能。
