ChatGPT API 使用指南

什么是 ChatGPT API？

ChatGPT API 是 OpenAI 提供的编程接口，允许开发者将 ChatGPT 的能力集成到自己的应用中。与网页版不同，API 按使用量计费，灵活性更高。

适合谁？

• 开发者：想在自己的产品中集成AI对话能力
• 企业：需要定制化的AI解决方案
• 研究者：需要批量处理文本任务
• 自动化爱好者：想搭建自己的AI工作流

获取 API Key

步骤

1. 注册 OpenAI 账号（参考注册指南）
2. 访问 platform.openai.com
3. 进入 API Keys 页面
4. 点击 "Create new secret key"
5. 保存生成的 Key（只会显示一次）

注意事项

• API Key 需要妥善保管，泄露可能导致费用损失
• 建议设置使用量上限（Usage limits）
• 可以为不同项目创建不同的 Key

计费说明

API 按 Token 数量计费。Token 大约对应：

• 英文：1个单词 ≈ 1-2 个 token
• 中文：1个汉字 ≈ 1-2 个 token

价格参考（2025年）

模型	输入价格	输出价格
GPT-4o	$2.5/百万token	$10/百万token
GPT-4o mini	$0.15/百万token	$0.6/百万token
GPT-3.5 Turbo	$0.5/百万token	$1.5/百万token

TIP

价格可能变动，请以 OpenAI 官网为准。对于大部分个人开发者，每月费用在 $5-20 之间。

快速开始

Python 示例

from openai import OpenAI

client = OpenAI(api_key="your-api-key")

response = client.chat.completions.create(
    model="gpt-4o",
    messages=[
        {"role": "system", "content": "你是一个有帮助的助手"},
        {"role": "user", "content": "用一句话解释什么是机器学习"}
    ]
)

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

Node.js 示例

import OpenAI from 'openai'

const client = new OpenAI({ apiKey: 'your-api-key' })

const response = await client.chat.completions.create({
  model: 'gpt-4o',
  messages: [
    { role: 'system', content: '你是一个有帮助的助手' },
    { role: 'user', content: '用一句话解释什么是机器学习' }
  ]
})

console.log(response.choices[0].message.content)

cURL 示例

curl https://api.openai.com/v1/chat/completions \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [
      {"role": "system", "content": "你是一个有帮助的助手"},
      {"role": "user", "content": "用一句话解释什么是机器学习"}
    ]
  }'

核心参数

参数	说明	建议值
model	使用的模型	gpt-4o 或 gpt-4o-mini
temperature	回答随机性（0-2）	创意任务0.7-1，精确任务0-0.3
max_tokens	最大输出长度	根据需求设置
top_p	核采样参数	通常保持默认1
stream	是否流式输出	需要实时显示时设为true

常见应用场景

• 智能客服：为网站添加AI问答助手
• 内容生成：批量生成产品描述、SEO文章
• 数据提取：从非结构化文本中提取关键信息
• 代码助手：构建开发者工具
• 翻译服务：搭建多语言翻译系统

国内使用方案

由于 API 也需要海外网络访问，国内开发者可以：

1. 使用代理：通过 Cloudflare Workers 等反代
2. 第三方中转：使用国内的 API 中转服务
3. 国内大模型API：阿里通义千问、百度文心等提供类似接口

最佳实践

1. 控制成本：开发阶段用 gpt-4o-mini，上线再切换
2. 缓存结果：相同输入缓存输出，避免重复调用
3. 错误处理：处理好限流、超时等异常情况
4. 安全存储：API Key 使用环境变量，不要硬编码
5. 设置限额：在 OpenAI 后台设置月度消费上限