OpenAI API 入门：从注册到第一次调用全流程

摘要

OpenAI API 是接入 GPT 系列模型最主流的方式。本文面向刚入门的开发者，讲清它的概念、密钥获取、计费逻辑与国内接入方案，并附上第一次调用的完整示例，让你从零跑通，同时建立起对成本和常见坑的基本认知。

一、OpenAI API 是什么

它是 OpenAI 对外开放的模型调用接口，通过它你可以在自己的程序里使用 GPT-4o、GPT-5 等模型完成对话、写作、代码、翻译等任务。这是标准的 RESTful 接口，发一个包含消息的请求，返回模型生成的内容，按 token 用量计费。

由于出现早、生态成熟，它的接口格式几乎成了行业事实标准。很多第三方模型和平台都提供”OpenAI 兼容”接口，方便开发者复用同一套代码。这意味着你今天学会调 GPT 的写法，明天想换成 Claude 或其他模型，往往只要改几个参数就行，学习成本一次投入、长期受用。

二、密钥与鉴权

调用 OpenAI API 需要一个以 sk_ 开头的密钥，请求时通过 Authorization: Bearer sk_xxx 头部携带。密钥相当于账户的通行证，务必妥善保管：不要硬编码进前端代码，不要提交到公开代码仓库，最好通过环境变量注入。

如果通过中转平台调用，密钥通常由平台签发，格式同样是 sk_ 开头。建议给不同项目分配独立密钥，这样一旦某个密钥泄露，影响范围可控，也便于按项目统计用量。

三、计费逻辑

计费按输入 token 加输出 token 计算，不同模型单价差异较大——轻量模型便宜、旗舰模型贵，两者可能相差十倍以上。token 是文本的最小计费单位，一段中文、一段代码都会被切成若干 token。

新手最容易踩的坑是：把长文档反复塞进上下文，导致输入 token 暴涨。多轮对话时，如果每次都把完整历史带上，token 会随对话轮次累积，成本悄悄翻倍。应对办法是定期裁剪历史、或用摘要压缩早期内容。

四、国内如何稳定调用

官方接口在国内直连体验不佳，主流做法是通过 API 中转平台。以 jiekou.vip 为例，它提供 OpenAI 兼容协议，只要改一下 base_url 就能接入：

from openai import OpenAI

client = OpenAI(
    api_key="sk_你的密钥",
    base_url="https://api.highwayapi.ai/openai"
)
resp = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "你好，帮我写一句问候语"}]
)
print(resp.choices[0].message.content)
print(resp.usage.prompt_tokens, resp.usage.completion_tokens)

代码和直连官方几乎一样，唯一改动是 base_url。最后一行打印了 usage，能直接看到这次请求用了多少输入和输出 token，是建立成本直觉的好习惯。

五、入门建议

第一，先用便宜的小模型跑通链路，确认能收到返回再换大模型，别一上来就烧旗舰模型。第二，坚持打印 usage 字段观察 token 消耗。第三，选一个带用量看板的平台，能实时看到每个 Key 的消耗，异常波动第一时间发现，避免失控。第四，注意 base_url 结尾是否需要 /v1，按平台文档填写，避免因路径拼接错误导致 404。

小结

OpenAI API 是使用 GPT 模型的标准入口，核心是”密钥鉴权 + 按 token 计费”。国内通过中转平台改一行 base_url 即可稳定调用。掌握了这套基础逻辑，再养成看 usage、控历史、分 Key 管理的习惯，切换到其他兼容模型也能无缝上手。