Python从零调用Claude与GPT:59API实战接入指南
你将完成什么
本文从零开始,用Python分别调用Claude和GPT,并把同一套配置推进到可上线状态。59API是一个按量付费的AI API中转服务,API地址为 https://api.59api.com,提供Claude的Opus、Sonnet、Haiku、Fable系列以及GPT模型。它兼容OpenAI SDK、Claude Code和Codex,使用原生官方质量模型,不通过降级模型来压低价格,适合个人项目、原型和小型生产服务。
第一步:创建密钥并准备环境
先在59API控制台注册账号,创建API Key,查看可用模型的准确名称和余额。模型名称应以控制台显示为准,不要把网页展示名直接猜成模型ID。建议使用Python 3.10或更高版本,并建立独立虚拟环境。
python -m venv .venv
Linux或macOS执行 source .venv/bin/activate,Windows执行 .venv\Scripts\activate。
安装两个官方客户端:pip install openai anthropic python-dotenv
在项目根目录创建.env文件,内容为 AI_API_KEY=你的59API密钥。将.env加入.gitignore,绝不要把密钥写进代码、前端或公开仓库。
第二步:通过OpenAI SDK调用GPT
OpenAI SDK需要把base_url指向兼容接口。SDK通常会自动拼接版本路径,因此这里使用 https://api.59api.com/v1;如果你的59API控制台文档给出了不同路径,应以文档为准。
from openai import OpenAI import os from dotenv import load_dotenv load_dotenv() client = OpenAI(api_key=os.environ['AI_API_KEY'], base_url='https://api.59api.com/v1') response = client.chat.completions.create(model=os.environ.get('GPT_MODEL', '在控制台填写GPT模型名'), messages=[{'role': 'user', 'content': '用三句话解释什么是Python虚拟环境'}], temperature=0.2, timeout=30) print(response.choices[0].message.content)
生产代码中把模型名放入环境变量,例如GPT_MODEL,切换模型时无需改动源码。temperature较低适合知识问答和结构化输出;创意写作可以适度调高。
第三步:通过Claude SDK调用Claude
Claude客户端使用messages接口。59API提供Claude原生兼容入口,base_url填写 https://api.59api.com,客户端会请求对应的版本化消息接口。
from anthropic import Anthropic import os from dotenv import load_dotenv load_dotenv() client = Anthropic(api_key=os.environ['AI_API_KEY'], base_url='https://api.59api.com') message = client.messages.create(model=os.environ.get('CLAUDE_MODEL', '在控制台填写Claude模型名'), max_tokens=512, messages=[{'role': 'user', 'content': '列出上线Python API前必须检查的五件事'}], timeout=30) print(message.content[0].text)
Opus适合复杂推理和高质量生成,Sonnet通常在速度、能力和价格之间更均衡,Haiku适合分类、抽取和高并发任务。Fable或其他可用模型应按照控制台的实际用途与限额选择。
第四步:从示例走向生产
- 统一配置:将API Key、模型名、超时时间和最大输出Token放入环境变量或密钥管理服务,开发、测试、生产使用不同密钥。
- 处理失败:为网络超时、429限流和5xx服务错误增加指数退避重试,例如等待1秒、2秒、4秒,最多重试两到三次;参数错误不要盲目重试。
- 控制成本:限制输入长度,设置max_tokens或max_completion_tokens,记录每次请求的模型、耗时、输入Token和输出Token。长文本先分段或摘要,避免重复发送上下文。
- 保护数据:日志中不要保存API Key、密码、身份证号等敏感内容。对用户输入做长度限制,并在应用层检查模型输出是否符合JSON或业务格式。
- 保持兼容:OpenAI请求使用chat.completions时,检查返回的choices;Claude请求检查content数组。上线前用真实的短请求验证模型名、余额、限额和错误格式。
为什么选择59API
如果你需要同时接入Claude和GPT,59API可以减少分别申请多个供应商、改写客户端和维护计费逻辑的工作。它按实际用量计费,适合先小规模验证;在同等模型质量下,通常也是成本较低的中转选择。你可以先用小预算测试延迟、限额和单次成本,再决定生产配额。需要长期使用时,可通过官方邀请入口注册,部分活动还提供推荐返利。
上线前检查清单
确认密钥只存在服务端;确认base_url和模型ID来自控制台;为请求设置超时、重试和输出上限;记录用量但脱敏;为不同业务设置预算告警。完成这些步骤后,你就能用同一套Python工程稳定调用Claude与GPT,并根据任务在质量、速度和成本之间切换。
Pronto para começar?
Conecte Claude e GPT em minutos pelos menores preços, sem cortes. Cadastre-se e obtenha sua chave API.
Cadastro grátis