如果你已经使用过 ChatGPT,那么你的 ChatGPT 账号即为 OpenAI 账号,直接登录即可。如果没有 OpenAI 账号,可以在官网进行注册。
由于国内的网络限制,注册过程可能会比较复杂,网上有很多教程可以参考。你也可以选择购买已有的账号,或者直接购买一个有效的 API Key。
获取 OpenAI API Key
登录 OpenAI 后,点击页面左侧弹出的侧边栏,选择“API Keys”进入 API Key 管理页面。
在该页面,你可以创建、删除和管理 API Keys。点击“Create new secret key”按钮,输入 Key 的名称,点击确认即可生成新的 API Key。生成后,一定要立即保存,因为关闭对话框后将无法再查看该 Key。
保存完成后,点击“Done”即可在页面上看到你创建的 API Key。
获取 API 使用额度
额度查询
点击侧边栏中的“Usage”进入使用页面,你将看到每天的花费和当前的额度。
页面右侧的“Credit Grants”区域会显示额度的状态,分为三种颜色:灰色(未使用)、绿色(已使用)和红色(已过期)。当额度显示为灰色时,才可以正常使用 API。
额度充值
要为 OpenAI API 充值,首先需要添加支付方式。点击侧边栏的“Setting”中的“Billing”进入账单页面,选择“Payment methods”管理支付方式。
由于网络封锁,国内的 Visa 卡可能无法使用,你可以尝试使用国外的信用卡或者网络支付卡。也可以参考我使用的卡片:ACCPAY,它支持在线充值,费用为 $15.99,并且有 3.5% 的充值手续费。
充值完成后,返回“Overview”页面点击“Add to credit balance”即可充值。充值后,你可以在“Usage”页面查看剩余的可用额度。
Python 使用测试
配置 Python 环境
确保你使用的 Python 版本为 3.7.1 或更高版本。为了简化管理,可以使用 Anaconda 创建一个虚拟环境。
安装 OpenAI 库
首先需要安装 OpenAI 的 Python 库,可以通过 pip 进行安装。
设置你的 API Key
OpenAI 会自动从环境变量中获取名为 “OPENAI_API_KEY” 的 Key。你可以有两种方式设置你的 Key:
- 为所有项目设置
你可以将 API Key 设置为系统环境变量。按 Win 键,搜索环境变量,然后在系统变量中添加OPENAI_API_KEY
。
完成后,你可以通过命令 echo %OPENAI_API_KEY%
来检查设置是否成功。
- 为单个项目设置
在项目目录下创建.env
文件,并将 API Key 写入该文件。例如:
bash
OPENAI_API_KEY=abc123
运行代码时,OpenAI 会自动读取环境变量中的 API Key。
测试代码
在代码中使用以下内容发送一个简单的 GPT-3.5 请求:
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."},
{"role": "user", "content": "Write a poem about recursion in programming."}
]
)
print(response.choices[0].message.content)
现在,你可以在 OpenAI 的 Usage 页面 查看你的 API 请求信息,包括花费和 token 数量。
API 功能简介(以 Python 为例)
文本生成
OpenAI API 支持生成文本内容。以下是一个简单的文本生成示例:
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?"}
]
)
在这个请求中,messages
参数包含了多个消息对象。每个消息对象包含 role
和 content
。常见的 role
类型包括:
system
(可选):设置 AI 的行为或对话规则。user
:向 AI 提问。assistant
:AI 的回应。
图像输入
OpenAI API 的 GPT-4 版本可以理解图像输入。你只需在消息中加入图像的 URL,例如:
python
{
"type": "image_url",
"content": ""
}
GPT-4 将自动处理并分析图像内容。
JSON 输出
为了始终获得 JSON 格式的输出,你可以在请求时指定 response_format
为 json_object
。
python
response_format={"type": "json_object"}
图像生成
OpenAI 还支持生成图像,以下是一个简单的图像生成示例:
python
response = client.image.create(
prompt="A futuristic cityscape at sunset.",
n=1,
size="1024x1024"
)
生成的图像可以通过相应的 API 请求进行查看和处理。