OpenAI API 使用指南:从注册到Python调用全流程

获取 OpenAI API Key

注册 OpenAI 账号

如果你已经使用过 ChatGPT,那么你的 ChatGPT 账号就是 OpenAI 账号,可以直接登录。如果没有账号,可以通过以下步骤注册:

由于 OpenAI 对国内的限制,国内用户注册可能较为复杂。网上有很多相关教程,这里不再赘述。如果你觉得过程繁琐,可以选择购买现成的账号或直接购买带有额度的 API Key。

生成 OpenAI API Key

登录后,将鼠标移动到页面左侧,会弹出一个侧边栏。点击“API Keys”进入 API Keys 页面。在这里,你可以管理(创建、删除等)所有的 API Key。

  1. 点击“Create new secret key”创建新的 API Key。
  2. 为 Key 命名,然后点击确认。
  3. 在弹出的对话框中,立即保存生成的 Key。注意,一旦关闭对话框,将无法再次查看该 Key。

保存完毕后,点击“Done”,你就可以在页面上看到新创建的 API Key 了。

获取 API 使用额度

查询额度

点击侧边栏中的“Usage”进入使用页面。页面左侧显示每日花费,右侧显示额度。

在右侧的 Credit Grants 区域,额度分为三种颜色:
– 灰色:未使用
– 绿色:已使用
– 红色:已过期

只有当额度处于灰色状态时,才能成功调用 API。

充值额度

点击侧边栏中的“Setting”下的“Billing”进入账单页面。在这里,你可以管理充值相关事项。

  1. 添加支付方式:点击“Payment methods”管理支付方式。
  2. 由于国内 Visa 卡可能无法使用,建议使用国际卡或虚拟卡。👉 野卡 | 一分钟注册,轻松订阅海外线上服务,支付方便,开卡费 $15.99,充值手续费 3.5%。

添加支付方式后,回到“Overview”页面,点击“Add to credit balance”进行充值。充值完成后,返回“Usage”页面即可看到额度变化。

在 Python 中调用 OpenAI API

配置 Python

确保 Python 版本为 3.7.1 以上。建议使用 Anaconda 创建虚拟环境,以便更好地管理依赖。

安装 OpenAI 库

使用以下命令安装 OpenAI 库:

bash
pip install openai

设置 API Key

OpenAI 默认会从环境变量中读取“OPENAI_API_KEY”,因此有以下两种设置方式:

  1. 全局设置
    在系统环境变量中添加 OPENAI_API_KEY,并在命令行中检查是否设置成功:

bash
echo %OPENAI_API_KEY%

  1. 项目设置
    在项目文件夹中创建 .env 文件,并添加以下内容:

env
OPENAI_API_KEY=你的Key

发送请求测试

以下是一个简单的 GPT-3.5 Turbo 聊天请求示例:

python
import os
import dotenv
from openai import OpenAI

dotenv.load_dotenv()

client = OpenAI(
api_key=os.environ.get(“OPENAI_API_KEY”),
)

response = client.chat.completions.create(
model=”gpt-3.5-turbo”,
messages=[
{“role”: “system”, “content”: “You are a poetic assistant, skilled in explaining complex programming concepts with creative flair.”},
{“role”: “user”, “content”: “Compose a poem that explains the concept of recursion in programming.”}
]
)

print(response.choices[0].message.content)

在“Usage”页面可以看到请求的花费和 Token 数量等信息。

功能介绍(以 Python 为例)

文本生成

官方教程:文本生成指南

GPT-4 不仅可以理解语言,还可以理解图像并返回文字。以下是一个示例:

python
response = client.chat.completions.create(
model=”gpt-3.5-turbo”,
messages=[
{“role”: “system”, “content”: “You are a helpful assistant.”},
{“role”: “user”, “content”: “Who won the world series in 2020?”},
{“role”: “assistant”, “content”: “The Los Angeles Dodgers won the World Series in 2020.”},
{“role”: “user”, “content”: “Where was it played?”}
]
)

图像理解

GPT-4 的 Vision 版本可以理解图像。只需在 user message 的 content 中添加 typeimage_url 的图像 URL。

JSON 模式

若想让模型输出 JSON 对象,可以将 response_format 设置为 { "type": "json_object" }。在使用 JSON 结果前,务必检查 finish_reason,避免使用被剪裁的 JSON 数据。

图像生成

OpenAI 还支持通过 API 生成图像,具体用法可以参考官方文档。

👉 野卡 | 一分钟注册,轻松订阅海外线上服务

上一篇 2025年8月18日
下一篇 2025年8月18日

相关推荐