← Retour aux guides

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，并根据任务在质量、速度和成本之间切换。

Tarifs · Docs