OpenAI API
开发者文档

集成OpenAI的强大AI能力到您的应用程序中。支持GPT-5、ChatGPT等多种模型， 提供简单易用的RESTful API接口。

快速开始

1. 获取API密钥

首先，您需要在OpenAI平台注册账户并获取API密钥：

  1. 访问 OpenAI平台
  2. 注册或登录您的账户
  3. 在API密钥页面生成新的密钥
  4. 安全保存您的API密钥

2. 安装SDK

选择您喜欢的编程语言安装相应的SDK：

Python

# 安装OpenAI Python库 pip install openai

Node.js

# 安装OpenAI Node.js库 npm install openai

cURL

# 直接使用HTTP请求，无需安装 curl -X POST https://api.openai.com/v1/chat/completions

3. 第一个API调用

以下是使用不同语言调用ChatGPT API的示例：

Python示例

from openai import OpenAI # 初始化客户端 client = OpenAI( api_key="your-api-key-here" ) # 发送聊天请求 response = client.chat.completions.create( model="gpt-4", messages=[ {"role": "user", "content": "Hello, how are you?"} ] ) print(response.choices[0].message.content)

Node.js示例

const OpenAI = require('openai'); // 初始化客户端 const openai = new OpenAI({ apiKey: 'your-api-key-here' }); // 发送聊天请求 async function main() { const response = await openai.chat.completions.create({ model: 'gpt-4', messages: [ {role: 'user', content: 'Hello, how are you?'} ] }); console.log(response.choices[0].message.content); } main();

主要API端点

聊天完成 (Chat Completions)

端点： POST https://api.openai.com/v1/chat/completions

用于与ChatGPT和GPT-4模型进行对话交互。

请求参数

参数 类型 必需 描述
model string 是 要使用的模型ID，如 "gpt-4", "gpt-3.5-turbo"
messages array 是 对话消息列表
max_tokens integer 否 生成的最大token数量
temperature number 否 控制输出随机性，0-2之间

文本完成 (Completions)

端点： POST https://api.openai.com/v1/completions

用于文本生成和补全任务。

请求参数

参数 类型 必需 描述
model string 是 要使用的模型ID
prompt string 是 输入提示文本
max_tokens integer 否 生成的最大token数量

图像生成 (Images)

端点： POST https://api.openai.com/v1/images/generations

使用DALL-E模型生成图像。

请求参数

参数 类型 必需 描述
prompt string 是 图像描述文本
n integer 否 生成图像数量，1-10
size string 否 图像尺寸，如 "1024x1024"

可用模型

GPT-4

最新的大型语言模型，具备强大的推理和创作能力。

  • • 模型ID: gpt-4
  • • 上下文长度: 8,192 tokens
  • • 训练数据截止: 2023年4月
  • • 支持多模态输入

GPT-3.5 Turbo

优化的GPT-3.5模型，速度快且成本效益高。

  • • 模型ID: gpt-3.5-turbo
  • • 上下文长度: 4,096 tokens
  • • 训练数据截止: 2021年9月
  • • 高性价比选择

DALL-E 3

最新的图像生成模型，能够创建高质量的图像。

  • • 模型ID: dall-e-3
  • • 支持尺寸: 1024x1024, 1792x1024
  • • 高质量图像生成
  • • 更好的文本理解

API定价

模型 输入价格 输出价格 单位
GPT-4 $0.03 $0.06 每1K tokens
GPT-3.5 Turbo $0.0015 $0.002 每1K tokens
DALL-E 3 $0.040 - 每张图像 (1024x1024)
DALL-E 3 $0.080 - 每张图像 (1792x1024)

💡 成本优化建议

  • 根据任务复杂度选择合适的模型
  • 设置合理的max_tokens限制
  • 使用缓存减少重复请求
  • 监控API使用量和成本

最佳实践

🔐 安全性

  • • 保护API密钥安全
  • • 使用环境变量存储密钥
  • • 定期轮换API密钥
  • • 设置使用限制和监控

⚡ 性能优化

  • • 实现请求重试机制
  • • 使用连接池
  • • 合理设置超时时间
  • • 批量处理请求

📊 监控和调试

  • • 记录API请求和响应
  • • 监控错误率和延迟
  • • 设置告警机制
  • • 分析使用模式

开始使用 OpenAI API

立即获取API密钥，将AI能力集成到您的应用中